[{"_1":2,"_193":-5,"_194":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_168":169},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":90,"_112":113,"_156":-5,"_157":11,"_158":22,"_159":11,"_160":11,"_161":-5,"_162":11,"_163":-5,"_164":165,"_166":114,"_167":-7},"canonicalUrl","https://hub.docker.com/r/dataedo/mcp/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","dataedo","reponame","mcp","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":73,"_74":75,"_80":11,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2026-09-01T09:20:02.227023Z","description","MCP server giving LLMs read-only access to your Dataedo data catalog metadata.","is_private","last_updated","2026-09-02T07:53:59.498411Z","last_modified","2026-09-02T07:17:37.452136Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",210,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","## Dataedo MCP\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that exposes a [Dataedo](https://dataedo.com) data catalog to MCP-compatible AI clients. The server lets LLMs answer questions about your live metadata - tables, columns, lineage, glossary terms, business domains, data products - without giving them write access to the catalog.\n\n### Key Features\n\n- **Read-only by design**. All 21 tools are annotated read-only; the server never mutates the catalog.\n- **Live metadata**. Every call hits your Dataedo instance directly - no stale snapshots, no extraction step.\n- **Token-efficient responses**. Search and list endpoints return compact, paginated results tuned for LLM context windows.\n- **Permission-aware**. Lineage, domain, and area responses honor the caller's view permissions on the backend.\n\n### Requirements\n\n- Node.js 20 or newer\n- A reachable Dataedo instance\n- A Personal Access Token (PAT) for that instance\n- Claude Desktop, Claude Code, Cursor, or any other MCP client\n\n### Getting started\n\nFirst, install the Dataedo MCP server with your client.\n\n**Standard config** works in most of the tools:\n\n```json\n{\n \"mcpServers\": {\n \"dataedo\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"dataedo-mcp\"],\n \"env\": {\n \"BACKEND_API_URL\": \"https://your-dataedo-instance.example.com\",\n \"DATAEDO_PAT\": \"your-personal-access-token\"\n }\n }\n }\n}\n```\n\n

Claude Code

\n\nUse the Claude Code CLI to add the Dataedo MCP server:\n\n```bash\nclaude mcp add dataedo \\\n -e BACKEND_API_URL=https://your-dataedo-instance.example.com \\\n -e DATAEDO_PAT=your-personal-access-token \\\n -- npx -y dataedo-mcp\n```\n\nOr add the standard config block to `.mcp.json` in your project root (or to the global config).\n\n

\n\n

Claude Desktop

\n\nFollow the MCP [Connect to local MCP servers](https://modelcontextprotocol.io/docs/develop/connect-local-servers) guide and use the standard config above.\n\n

\n\n

Cursor

\n\nGo to `Cursor Settings → MCP → Add new MCP Server`, then click `Edit` and paste the standard config above (`BACKEND_API_URL` and `DATAEDO_PAT` go in the `env` block).\n\n

\n\n

Copilot CLI

\n\nUse the Copilot CLI to interactively add the Dataedo MCP server:\n\n```bash\n/mcp add\n```\n\nAlternatively, edit `~/.copilot/mcp-config.json` and add the standard config block above (with `type: \"local\"` and `tools: [\"*\"]`).\n\n

\n\n### Configuration\n\nStdio mode is configured via two environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BACKEND_API_URL` | yes | Root URL of your Dataedo instance, e.g. `https://dataedo.example.com` — without the `/api` suffix (the server appends `/api/...` itself) |\n| `DATAEDO_PAT` | yes | Personal Access Token used for all backend calls. Treat like a password. |\n\n### Personal Access Token\n\nGenerate a PAT in your Dataedo instance: profile page → **Personal Access Tokens** → create token. The token is shown once — copy it into your client config. It grants the same read access as your user account (store it carefully), expires after 180 days by default, and can be revoked from the same page at any time.\n\n### Self-hosting (HTTP mode)\n\nThe server can also run as a long-lived HTTP service for remote MCP clients. Authentication is the same PAT, sent by each client as an `Authorization: Bearer ` header — no OAuth setup, no Azure AD, no server-side credentials. Example (Claude Code):\n\n```bash\nclaude mcp add --transport http dataedo https://mcp.yourdomain.com/mcp \\\n --header \"Authorization: Bearer ${DATAEDO_PAT}\"\n```\n\nThe npm package only ships stdio - for the HTTP deployment and per-client configuration, see [CONFIGURATION.md](./CONFIGURATION.md).\n\n### Troubleshooting\n\n**`Missing required environment variable: DATAEDO_PAT`**\nThe client didn't pass the env var to the spawned process. Double-check the `env` block in your client config.\n\n**Tools don't appear in the client**\n- Restart the client after changing config.\n- Verify the config file path - Claude Desktop logs the active path on startup.\n- Run the server manually (`npx -y dataedo-mcp` with env vars set) and check stderr for errors.\n\n**`401 Unauthorized` from tool calls**\nThe PAT is missing, expired, or invalid. Generate a new one and update the config.\n\n**`ECONNREFUSED` / network errors**\n`BACKEND_API_URL` is wrong or unreachable from your machine. Test with `curl -I $BACKEND_API_URL`.\n\n### Tools\n\n

Search

\n\n- **search**\n - Description: Search the catalog by name, title, or description across 9 object groups: `DATA_SET`, `REPORT`, `TERM`, `BUSINESS_DOMAIN`, `DATA_DOMAIN`, `DATA_SOURCE`, `LOOKUP`, `PROGRAM`, `DATA_PRODUCT`. Use this first to find object IDs for other tools.\n - Parameters:\n - `input` (string, optional): Search phrase. Multiple words contribute to ranking.\n - `group` (string, optional): Limit to a single object group. Returns up to 50 results per group when set, or 10 per group when omitted.\n - `limit` (number, optional): Result cap, 1–100.\n - Read-only: **true**\n\n- **search_details**\n - Description: Search detail-level objects - columns, report fields, procedure parameters - across `COLUMN`, `REPORT_FIELD`, `PROGRAM_INPUT`. Separate from `search` because the underlying tables are large; uses prefix-matching FTS only.\n - Parameters:\n - `input` (string, optional): Search phrase.\n - `group` (string, optional): One of `COLUMN`, `REPORT_FIELD`, `PROGRAM_INPUT`.\n - `limit` (number, optional): Result cap, 1–100.\n - Read-only: **true**\n\n

\n\n

Tables & columns

\n\n- **list_tables**\n - Description: List tables in a database or report instance. Paginated; supports name and type filtering.\n - Parameters:\n - `id` (number): Database or report instance ID.\n - `search` (string, optional): Filter by name.\n - `objectType` (string, optional): Filter by type, e.g. `TABLE`, `VIEW`, `REPORT`, `PROCEDURE`, `SQL_QUERY`.\n - `page` (number, optional): Page number, default 1.\n - `pageSize` (number, optional): Page size, default 100.\n - Read-only: **true**\n\n- **get_table**\n - Description: Get full details for a table - columns, description, schema, parent database.\n - Parameters:\n - `id` (number): Table ID.\n - Read-only: **true**\n\n- **get_column**\n - Description: Get full details for a single column - data type, description, custom fields.\n - Parameters:\n - `id` (number): Column ID.\n - Read-only: **true**\n\n- **get_relationships**\n - Description: Foreign-key relationships for a table - answers \"how does this table connect to others\".\n - Parameters:\n - `id` (number): Table ID.\n - Read-only: **true**\n\n

\n\n

Stored procedures

\n\n- **list_procedures**\n - Description: List procedures in a database. Paginated; supports name and type filtering.\n - Parameters:\n - `id` (number): Database ID.\n - `search` (string, optional): Filter by name.\n - `objectType` (string, optional): Filter by type.\n - `page` (number, optional): Page number, default 1.\n - `pageSize` (number, optional): Page size, default 100.\n - Read-only: **true**\n\n- **get_procedure**\n - Description: Get full details for a stored procedure or function.\n - Parameters:\n - `id` (number): Procedure ID.\n - Read-only: **true**\n\n

\n\n

Databases

\n\n- **get_database**\n - Description: Get full details for a database.\n - Parameters:\n - `id` (number): Database ID.\n - Read-only: **true**\n\n

\n\n

Reports

\n\n- **get_report_instance**\n - Description: Get full details for a reporting instance.\n - Parameters:\n - `id` (number): Report instance ID.\n - Read-only: **true**\n\n- **list_reports**\n - Description: List reports under a report instance. Paginated; supports name filtering.\n - Parameters:\n - `id` (number): Report instance ID.\n - `search` (string, optional): Filter by name.\n - `page` (number, optional): Page number, default 1.\n - `pageSize` (number, optional): Page size, default 100.\n - Read-only: **true**\n\n- **get_report**\n - Description: Get full details for a single report.\n - Parameters:\n - `id` (number): Report ID.\n - Read-only: **true**\n\n

\n\n

Lineage

\n\n- **get_lineage**\n - Description: Returns the upstream/downstream lineage subgraph for an object as `{ nodes, edges, truncated }`. Use to answer \"what feeds X\" / \"what depends on X\". When `truncated` is true, raise `maxDepth` or `nodeLimit`, or re-query from a more specific node.\n - Parameters:\n - `objectType` (string): e.g. `TABLE`, `VIEW`, `REPORT`, `PROCEDURE`, `SQL_QUERY`.\n - `object_id` (integer): Object ID from `search` or other tools.\n - `direction` (string, optional): `upstream`, `downstream`, or `both` (default).\n - `maxDepth` (integer, optional): BFS hops, 1–20. Default 3.\n - `nodeLimit` (integer, optional): Cap on total nodes, 1–1000. Default 50.\n - Read-only: **true**\n\n- **get_column_lineage**\n - Description: Column-level lineage - trace how a column or procedure parameter is derived, or which downstream columns depend on it.\n - Parameters:\n - `objectType` (string): `column` or `parameter`.\n - `id` (number): Column or parameter ID.\n - `direction` (string): `upstream`, `downstream`, or `both`.\n - Read-only: **true**\n\n

\n\n

Glossary & terms

\n\n- **get_glossary**\n - Description: Get full details for a glossary.\n - Parameters:\n - `id` (number): Glossary ID.\n - Read-only: **true**\n\n- **get_glossary_entries**\n - Description: Glossary/business terms linked to a specific object. Use to surface business context for a table, view, report, etc.\n - Parameters:\n - `objectType` (string): The object's type, e.g. `TABLE`, `VIEW`.\n - `id` (number): The object ID.\n - Read-only: **true**\n\n- **get_term**\n - Description: Get full details for a glossary term - name, definition, status.\n - Parameters:\n - `id` (number): Term ID.\n - Read-only: **true**\n\n- **get_term_linked_objects**\n - Description: Data objects linked to a glossary term - answers \"which tables/columns use this business term\".\n - Parameters:\n - `id` (number): Term ID.\n - Read-only: **true**\n\n

\n\n

Domains & data products

\n\n- **get_domain_overview**\n - Description: Domain overview - description, workflow status, areas, linked terms, linked assets. Areas are filtered by the caller's permissions.\n - Parameters:\n - `id` (number): Domain ID.\n - Read-only: **true**\n\n- **get_area_overview**\n - Description: Area overview - description, workflow status, parent domain, child areas, linked terms, linked assets.\n - Parameters:\n - `id` (number): Area ID.\n - Read-only: **true**\n\n- **get_data_product**\n - Description: Data product overview - title, description, type, workflow status, linked assets, and a data quality summary (validity score and validity ratio).\n - Parameters:\n - `id` (number): Data product ID.\n - Read-only: **true**\n\n

","has_starred","hub_user","dataedoteam","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":22,"_84":11,"_85":11},"read","write","admin","user","storage_size",66950526,"orgData",{"_91":92,"_93":94,"_95":96,"_97":33,"_98":99,"_100":101,"_102":99,"_103":104,"_105":106,"_107":108,"_109":101,"_110":101,"_111":22},"id","dabb16cc633b42709269264dc536346f","uuid","dabb16cc-633b-4270-9269-264dc536346f","type","organization","orgname","full_name","Dataedo","location","","company","profile_url","https://dataedo.com","date_joined","2022-05-18T09:06:22.10521Z","gravatar_url","https://www.gravatar.com/avatar/8dddb45ca6e1d14fd0163d267c8e6f92?s=80&r=g&d=mm","gravatar_email","badge","is_active","recentTags",[114,150],{"_115":44,"_116":117,"_118":119,"_120":121,"_91":122,"_123":124,"_50":139,"_140":117,"_141":73,"_142":56,"_57":143,"_144":145,"_146":130,"_147":139,"_148":66,"_149":22},"content_type","creator",24936347,"digest","sha256:c369b48c8baefb05979f78aba13798a25a8543ad4cbb637d0a94f8444da5198e","full_size",62712063,1292452320,"images",[125],{"_126":127,"_118":119,"_128":101,"_129":130,"_131":132,"_133":134,"_135":101,"_136":-5,"_137":121,"_63":66,"_138":-5},"architecture","amd64","features","last_pulled","2026-10-29T04:11:06.644475913Z","last_pushed","2026-09-02T07:53:55.841601335Z","os","linux","os_features","os_version","size","variant","2026-09-02T07:53:59.390885Z","last_updater","last_updater_username","media_type","latest","repository",32330820,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_115":44,"_116":117,"_118":119,"_120":121,"_91":151,"_123":152,"_50":154,"_140":117,"_141":73,"_142":56,"_57":155,"_144":145,"_146":130,"_147":154,"_148":66,"_149":22},1292452268,[153],{"_126":127,"_118":119,"_128":101,"_129":130,"_131":132,"_133":134,"_135":101,"_136":-5,"_137":121,"_63":66,"_138":-5},"2026-09-02T07:53:56.088968Z","v1.0.0","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":170,"_177":178,"_164":191,"_192":11},{"_40":171,"_42":172,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":173,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":73,"_74":174,"_80":11,"_81":176,"_86":33,"_87":88},[],[44],[56],{"_76":11,"_77":175},[79],{"_83":22,"_84":11,"_85":11},"tags",{"_179":180,"_181":-5,"_182":-5,"_183":184},"count",2,"next","previous","results",[185,188],{"_115":44,"_116":117,"_118":119,"_120":121,"_91":122,"_123":186,"_50":139,"_140":117,"_141":73,"_142":56,"_57":143,"_144":145,"_146":130,"_147":139,"_148":66,"_149":22},[187],{"_126":127,"_118":119,"_128":101,"_129":130,"_131":132,"_133":134,"_135":101,"_136":-5,"_137":121,"_63":66,"_138":-5},{"_115":44,"_116":117,"_118":119,"_120":121,"_91":151,"_123":189,"_50":154,"_140":117,"_141":73,"_142":56,"_57":155,"_144":145,"_146":130,"_147":154,"_148":66,"_149":22},[190],{"_126":127,"_118":119,"_128":101,"_129":130,"_131":132,"_133":134,"_135":101,"_136":-5,"_137":121,"_63":66,"_138":-5},[],"canDeleteTags","actionData","errors"]

dataedo/mcp

Tags for dataedo/mcp