> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server overview

> What the Summand MCP server is and what it exposes.

The Summand MCP server implements the [Model Context Protocol](https://modelcontextprotocol.io) and gives any MCP-aware client access to your Summand connectors, datasets, views, models and their computed-context layer.

It's hosted by Summand at `https://mcp.summand.com/mcp` and uses the streamable-HTTP transport with OAuth 2.1 authentication. There's nothing to install — point your client at the URL, sign in, and start asking questions.

> [card] [Connect a client](https://docs.summand.com/api-reference/mcp/connect.md)
>
> Wire up claude.ai, ChatGPT, or any other OAuth-aware MCP client.

## What the server exposes

The server registers 50 tools in five groups:

| Group | Tools |
| - | - |
| Discover and understand | `list_data_connectors`, `list_connector_tables`, `list_datasets`, `list_views`, `get_view`, `list_workspaces`, `get_workspace`, `get_workspace_context`, `search`, `describe_dataset`, `get_columns`, `get_semantic_data`, `get_surprises`, `compare_schemas`, `list_findings` |
| Monitor | `get_dataset_schedule`, `list_dataset_runs`, `list_dataset_alerts`, `list_shares`, `get_task_status`, `get_export_status`, `get_view_status` |
| Query and predict | `run_query`, `get_dataset_rows`, `list_models`, `list_model_versions`, `get_model_details`, `predict`, `counterfactual` |
| Change things | `create_view`, `update_view`, `delete_view`, `share_resource`, `set_visibility`, `delete_dataset`, `delete_connector`, `create_experiment`, `promote_model`, `archive_model`, `propose_finding`, `update_finding`, `review_finding`, `update_dataset_context`, `update_workspace_context` |
| Run jobs | `train_model`, `load_semantic_components`, `ingest_tables`, `resync_dataset`, `run_experiment`, `export_pdf` |

`run_query` accepts only read-only `SELECT` statements and returns at most 1,000 rows.

Read, query and predict tools work for everyone who connects. The tools that change things or run jobs, except `export_pdf`, need the Member org role or higher, so members with the **Chat** role can't use them. Every delete, share, visibility change, view edit, finding, context edit, training run and ingestion returns a preview first and only runs when you confirm it in the client.

See the [tools reference](https://docs.summand.com/api-reference/mcp/tools.md) for parameters and example outputs.

## Authentication model

> [!NOTE]
>
> Access is scoped to whatever the caller already has in Summand — owned resources plus anything shared with them. There is no way to access or change a connector or dataset over MCP that you couldn't in the dashboard.

Authentication uses OAuth 2.1 bearer tokens issued by Summand's identity provider. Standard MCP discovery is supported, so clients auto-discover the authorization server on a `401` and register themselves dynamically — no pre-registration required.

You'll typically only need to paste the endpoint URL into your client; everything else happens in the OAuth redirect.

## What's next

> [card] [Connect a client](https://docs.summand.com/api-reference/mcp/connect.md)
>
> Step-by-step setup for claude.ai and ChatGPT.

> [card] [Tools reference](https://docs.summand.com/api-reference/mcp/tools.md)
>
> Parameters and example prompts for every tool.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.