Skip to main content

OpenMetadata MCP Tools Reference

All OpenMetadata MCP tools, with parameters and examples.

Available Tools

Discover

Search and find data assets across your catalog using keyword, semantic, or natural language queries.

search_metadata

Description: Find data assets and business terms by keyword. Use when you know specific names, owners, tags, tiers, services, or column names. Use Cases:
  • Discover tables containing specific data
  • Find dashboards related to business areas
  • Search for glossary terms
  • Locate pipelines by name or description
Parameters Entity Types
  • Service Entities: databaseService, messagingService, apiService, dashboardService, pipelineService, storageService, mlmodelService, metadataService, searchService
  • Data Asset Entities: apiCollection, apiEndpoint, table, storedProcedure, database, databaseSchema, dashboard, dashboardDataModel, pipeline, chart, topic, searchIndex, mlmodel, container
  • User Entities: user, team
  • Domain Entities: domain, dataProduct
  • Governance Entities: metric, glossary, glossaryTerm
Examples Basic Search:
Search for a Specific Entity Type:
Search with Additional Fields:
Sample Response:
Description: Find data assets by meaning using vector search (setup guide). Use for exploratory queries where you don’t know exact names. Returns conceptually related assets even when no keywords match. Use Cases:
  • Explore data when you don’t know exact table names
  • Find assets related to a concept (e.g., “customer spending behavior”)
  • Discover hidden relationships across services
Parameters Examples Conceptual Search:
Search with Filters and Threshold:

Inspect

Retrieve detailed information about specific entities and company knowledge pills.

get_entity_details

Description: Retrieve full details for a specific entity by fully qualified name (FQN). Pass the exact fullyQualifiedName value from search results — do not construct FQNs manually. Parameters Examples Get Table Details:
Get Dashboard Details:
Sample Response:

Lineage & Impact

Explore data dependencies, trace upstream sources, and analyze downstream impact.

get_entity_lineage

Description: Retrieve upstream and downstream lineage for any entity to understand data dependencies and perform impact analysis. Pass the exact fullyQualifiedName from search results. Parameters Examples Get Full Lineage:
Downstream-Focused Impact Analysis:

create_lineage

Description: Create a lineage relationship between two entities. Requires the id (UUID) and type of both the source and destination entities. Parameters Example
Tip: Retrieve entity UUIDs from get_entity_details results before calling create_lineage.

root_cause_analysis

Description: Trace a data quality failure back to its origin by traversing data quality lineage across pipeline hops. Parameters Example

Knowledge

Create and manage glossaries, terms, and reusable context memories.

create_glossary

Description: Create a new glossary to organize business terms. Set mutuallyExclusive: true to restrict entities to a single term from the glossary at a time. Parameters Examples Create a Business Glossary:
Create a Mutually Exclusive Technical Glossary:
Sample Response:

create_glossary_term

Description: Create a new term within an existing glossary. Supports hierarchical parent–child relationships between terms. Parameters Examples Create a Root-Level Term:
Create a Child Term:

Govern & Classify

Define and apply classifications, tags, domains, data products, and entity updates.

create_classification

Description: Create a new Classification in OpenMetadata. A Classification is a top-level container that groups related Tags (e.g., PII, Tier). The name becomes the root segment of every tag FQN under it. The mutuallyExclusive flag is immutable once the classification exists. Parameters Example

create_tag

Description: Create a new Tag inside a Classification in OpenMetadata. The tag FQN is Classification.TagName (e.g., PII.Sensitive). At least one of classification or parent must be provided. Parameters Examples Create a top-level tag:
Create a nested tag:

create_domain

Description: Create a new Domain in OpenMetadata. A Domain is a top-level governance grouping of data assets. To create a child domain, set parent to the FQN of an existing parent domain. domainType defaults to Aggregate if omitted. Parameters Examples Create a top-level domain:
Create a child domain:

create_data_product

Description: Create a new Data Product in OpenMetadata. A Data Product groups data assets that deliver business value and must belong to at least one Domain. All referenced domain FQNs must already exist. Parameters Example

patch_entity

Description: Update an existing entity’s properties using JSON Patch (RFC 6902). Use get_entity_details first to retrieve the current state before constructing a patch. Parameters Example

Data Quality

Access test definitions and create test cases to validate your data assets.

get_test_definitions

Description: List test definitions available in OpenMetadata for tables or columns. Call this before create_test_case to identify valid test types and their required parameters. Parameters Example

create_test_case

Description: Create a data quality test case for a table or column. For column tests, ensure the column’s data type is listed in the test definition’s supportedDataTypes. Parameters Example

Metrics

Define and track measurable business and technical KPIs.

create_metric

Description: Create a new metric entity in OpenMetadata to track and standardize business KPIs. Parameters Example