Module mcp 

Model Context Protocol (MCP) HTTP handlers.

Exposes Materialize data products to AI agents via JSON-RPC 2.0 over HTTP POST.

Endpoints

• /api/mcp/agents - User data products for customer AI agents
• /api/mcp/observatory - System catalog (mz_*) for troubleshooting

Tools

Agents: get_data_products, get_data_product_details, query Observatory: query_system_catalog

Data products are discovered via mz_internal.mz_mcp_data_products system view.

Modules

error_codes 🔒

JSON-RPC 2.0 error codes.

Structs

Capabilities 🔒

ClientInfo 🔒

ContentBlock 🔒

GetDataProductDetailsParams 🔒

InitializeParams 🔒

InitializeResult 🔒

McpError 🔒

McpRequest 🔒

JSON-RPC 2.0 request. Requests have id; notifications don’t.

McpResponse 🔒

QueryParams 🔒

QuerySystemCatalogParams 🔒

ServerInfo 🔒

TableReferenceCollector 🔒

Collects table references from SQL AST with their schema qualification.

ToolContentResult 🔒

ToolDefinition 🔒

ToolsListResult 🔒

Enums

McpEndpointType 🔒

McpMethod 🔒

MCP method variants with their associated parameters.

McpRequestError 🔒

MCP request errors, mapped to JSON-RPC error codes.

McpResult 🔒

Typed MCP response results.

ToolsCallParams 🔒

Tool call parameters, deserialized via adjacently tagged enum. Serde maps name to the variant and arguments to the variant’s data.

Constants

DISCOVERY_QUERY 🔒

Functions

execute_query 🔒

execute_sql 🔒

Execute SQL via execute_request from sql.rs.

get_data_product_details 🔒

get_data_products 🔒

handle_initialize 🔒

handle_mcp_agents

Agents endpoint: exposes user data products.

handle_mcp_method 🔒

handle_mcp_observatory

Observatory endpoint: exposes system catalog (mz_*) only.

handle_mcp_request 🔒

handle_mcp_request_inner 🔒

handle_tools_call 🔒

handle_tools_list 🔒

query_system_catalog 🔒

validate_readonly_query 🔒

Validates query is a single SELECT, SHOW, or EXPLAIN statement.

validate_system_catalog_query 🔒

Validates query references only mz_* system catalog tables.