Skip to content

MCP Server

The Model Context Protocol (MCP) server exposes Metaxy's feature graph and metadata store operations to AI assistants, enabling them to explore your feature definitions and query metadata.

Installation

Install Metaxy with the mcp extra:

uv add metaxy[mcp]

pip install metaxy[mcp]

Running the Server

Run the MCP server from your Metaxy project directory:

metaxy mcp # (1)!
  1. Use uv run metaxy mcp to run the server within the project's Python environment.

The server uses the standard Metaxy configuration discovery, loading metaxy.toml from the current directory or parent directories.

Configuration

Claude Code

Add the MCP server to your project's .claude/settings.json:

{
  "mcpServers": {
    "metaxy": {
      "command": "metaxy",
      "args": ["mcp"]
    }
  }
}

Available Tools

The MCP server provides the following tools:

get_config

Get the current Metaxy configuration as JSON.

Returns:

The full Metaxy configuration serialized as JSON, including all settings like project, store, entrypoints, stores, etc.

get_feature

Get the complete specification for a feature.

Parameters:

Name Type Required Default Description
feature_key str Yes —

get_metadata

Query metadata for a feature from a store.

Parameters:

Name Type Required Default Description
feature_key str Yes —
store_name str Yes —
columns list[str] | None No None
filters list[str] | None No None
with_feature_history bool No False
with_sample_history bool No False
include_soft_deleted bool No False
allow_fallback bool No True
sort_by list[str] | None No None
descending bool | list[bool] No False
limit int No 50

get_store

Get display information for a metadata store.

Parameters:

Name Type Required Default Description
store_name str Yes —

list_features

List all registered features with their metadata.

Matches the output format of mx list features --format json.

Parameters:

Name Type Required Default Description
project str | None No None
verbose bool No False

list_stores

List all configured metadata stores.

Returns:

List of dictionaries with 'name' and 'type' for each store