OpenMetadata MCP Server: Setup for Claude, Cursor and Other Apps

• Searches data assets by keyword

  Keyword search for tables, dashboards, tests and other assets by name, owner, tag, tier, service or column name. It can read many known assets in one call.

  Try: “Find tables owned by the finance team tagged PII.”

  Read · search_metadata

• Finds data by meaning

  Finds data assets that match a plain-language description, even when no keywords match. It needs vector embeddings set up on the server.

  Try: “Find tables about customer spending behavior.”

  Read · semantic_search

• Opens one or more assets

  Returns full details of an asset or up to 10 at once, including custom properties and a certification with its expiry resolved.

  Try: “Show details for the orders table.”

  Read · get_entity_details

• Shows upstream and downstream lineage

  Returns a compact lineage graph for an asset, at table level by default, or for one column. Transformation SQL is included only if asked.

  Try: “What feeds the revenue dashboard?”

  Read · get_entity_lineage

• Traces data quality failures

  Looks upstream for failing tests that may explain a problem on an asset, then shows the downstream assets affected.

  Try: “Why is the daily_sales table failing its tests?”

  Read · root_cause_analysis

• Lists data quality test types

  Lists the test definitions you can use to create a test case on a table or column.

  Try: “What tests can I add to a column?”

  Read · get_test_definitions

• Finds business definitions

  Searches glossary terms, metrics and Context Center articles for a business question and returns definitions and candidate assets.

  Try: “What does monthly active user mean here?”

  Read · find_context

• Resolves a glossary term or metric

  Returns a glossary term or metric with its definition, the assets and columns it is bound to, sample values and related metrics. Not in the 2.0.7 release; it is on the main branch.

  Try: “Which columns hold the net revenue metric?”

  Read · get_concept_context

• Reads Context Center notes

  Finds or reads question-and-answer notes extracted from files in the Context Center. Searching needs vector embeddings on the server.

  Try: “What does our data retention policy note say?”

  Read · company_context

• Shows who you are in OpenMetadata

  Returns your identity, teams, roles, domains and the assets you own or follow. It cannot read another user.

  Try: “What do I own in OpenMetadata?”

  Read · get_user_context

• Reads a persona's AI context

  Returns the shared AI context document for a persona, in parts, with the persona admin's guidance if one is set.

  Try: “Load the context for the analyst persona.”

  Read · get_persona_context

• Shows fields for a new asset

  Lists the fields, types and allowed values the create tool accepts for one asset type.

  Try: “What do I need to create a glossary term?”

  Read · describe_entity_type

• Creates a new asset

  Creates a new entity such as a glossary term. It never changes an existing one and fails if the name is taken.

  Try: “Create a glossary term called Churn under Finance.”

  Write · create_entity

• Edits an existing asset

  Updates an existing asset using a JSON Patch, for example owners, tags or descriptions. It takes effect immediately and can overwrite existing values.

  Try: “Set the owner of the orders table to the data team.”

  Write · patch_entity

• Adds lineage between two assets

  Creates a lineage link between two assets.

  Try: “Link raw_orders to the orders table as its source.”

  Write · create_lineage

• Adds a data quality test

  Creates a test case on a table or column from a test definition. It takes effect immediately.

  Try: “Add a not-null test on orders.customer_id.”

  Write · create_test_case

• Queries the knowledge graph

  Runs a read-only SPARQL query over the OpenMetadata knowledge graph. Non-admins get SELECT only and need the ExecuteSparqlQuery permission. Not in the 2.0.7 release; it is on the main branch.

  Try: “List column lineage paths into the revenue table.”

  Read · sparql_query

• Shows what is near an asset

  Returns the assets within 1 to 3 hops of an asset in the knowledge graph, such as columns, tags, owners and lineage. Not in the 2.0.7 release; it is on the main branch.

  Try: “What is connected to the customers table?”

  Read · entity_neighborhood

• Finds everything with a tag

  Finds all assets with a classification tag or glossary term. It needs the ExecuteSparqlQuery permission. Not in the 2.0.7 release; it is on the main branch.

  Try: “Show me everything tagged PII.Sensitive.”

  Read · find_by_tag

• Checks graph data rules

  Validates one asset's graph data, or all of it, against SHACL rules. Admin only. Not in the 2.0.7 release; it is on the main branch.

  Try: “Validate the orders table's graph data.”

  Read · shacl_validate

• Describes the data ontology

  Returns the OpenMetadata ontology, or the definition of one class or property. Not in the 2.0.7 release; it is on the main branch.

  Try: “What classes does the ontology define?”

  Read · ontology_describe

Watch out for

• It can edit assets and add lineage and tests

  Four tools create or change metadata, and their descriptions say writes take effect immediately and can overwrite values. Sign in with a read-only role if you only want search. github.com

• It acts with your permissions

  Whatever your account can see and change, the assistant can too. Use a limited account for experiments. github.com

• Some tools need extra permissions

  The graph query tools need the ExecuteSparqlQuery permission, and the validation tool is admin only. github.com

Security advisories