Motley MCP Server¶
The Motley MCP server exposes your Motley workspace as a set of tools that any MCP-compatible AI agent can call. It handles authenticated communication with the Motley API and gives an agent the ability to query your data, manage your semantic layer, and generate documents — all in conversation.
The Claude plugin uses the Motley MCP server under the hood, but you can connect the server directly to any MCP-compatible AI tool.
Connecting the MCP server¶
The connection URL and authentication token for your workspace are available in Settings → MCP Server in the Motley interface.
General steps for any MCP-compatible client:
- Open your AI tool's connector or MCP settings
- Add a new MCP server using the Motley connection URL
- Authenticate using your workspace token from Motley Settings
- Confirm the server shows as connected
Available tools¶
| Tool | Description |
|---|---|
list_sources |
List all data sources connected to the workspace |
get_source |
Get details and ingestion status for a specific source |
list_models |
List all semantic models defined for a source |
get_model |
Inspect a model: SQL definition, dimensions, measures, and sample rows |
create_model |
Create a new model from a SQL query; auto-generates dimensions and measures from the result schema |
update_model |
Add, remove, or modify dimensions and measures on an existing model |
list_documents |
List documents in the workspace |
get_document |
Get a document by ID, including its blocks and generation status |
create_document |
Generate a new document from a natural language description |
update_document |
Update an existing document's blocks or content |