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

# MCP Integration

> Expose Share Of Model data to LLM agents via Model Context Protocol

Share Of Model exposes a read-only [Model Context Protocol](https://modelcontextprotocol.io) surface so LLM agents — Claude.ai, Claude Desktop, Claude Code, or any MCP-compatible client — can query your workspace data directly.

## What is exposed

Three things reach your client through the single MCP endpoint:

* **Tools** — the endpoints tagged `mcp` in the [API Reference](/api-reference/introduction), from both the Core API and the Search API, plus `get_current_user` for personalised answers. They are read-only by design: agents can browse analyses, metrics, and brand catalogs, but cannot mutate state.
* **Prompts** — ten guided analysis workflows you invoke by name. See [Prompts](#prompts) below.
* **Skills** — curated domain knowledge (metric glossaries, reporting playbooks, security and compliance) that the assistant loads on its own, so you don't have to explain what a metric means before asking about it. The documentation search tools are also mounted, letting the assistant look things up in these docs while it works.

## Server URL

```
https://mcp.shareofmodel.ai/mcp
```

Transport: Streamable HTTP.

## Authentication

The server uses **OAuth 2.0**. You do not pass an API key or a JWT — on first connection, the client opens your browser, you sign in with your Share Of Model account (same credentials as the web app), and the client stores the resulting token. There is nothing to configure manually.

## Connect from Claude Code

```bash theme={null}
claude mcp add --transport http share-of-model https://mcp.shareofmodel.ai/mcp
```

The first time you invoke a tool, Claude Code opens your browser to complete the OAuth flow. Subsequent calls reuse the stored token.

## Connect from Claude.ai or Claude Desktop

1. Open **Settings** → **Connectors**.
2. Scroll to the bottom and click **Add custom connector**.
3. Paste `https://mcp.shareofmodel.ai/mcp` and click **Connect**.
4. Sign in with your Share Of Model account in the browser window that opens.

The Share Of Model tools then appear in the tools panel of any new conversation.

## Connect from MCP Inspector

```bash theme={null}
npx @modelcontextprotocol/inspector
```

In the Inspector UI, choose **Streamable HTTP** as the transport, paste the server URL, then click **Connect**. You will be prompted to sign in on first use.

## Prompts

Rather than composing a request yourself, you can invoke a pre-built workflow by name:

| Prompt                         | What it produces                            |
| ------------------------------ | ------------------------------------------- |
| `brand_visibility_brief`       | Executive brief on a brand's AI visibility. |
| `compare_brands`               | Head-to-head brand comparison.              |
| `weekly_brand_update`          | Week-over-week metrics summary.             |
| `competitive_landscape`        | Top brands in a category.                   |
| `persona_breakdown`            | Performance by target persona.              |
| `attribute_deep_dive`          | Deep analysis of a single attribute.        |
| `search_visibility_scorecard`  | Search visibility scorecard.                |
| `visibility_gap_vs_competitor` | Search query gaps versus a competitor.      |
| `asset_effectiveness_report`   | Creative asset evaluation summary.          |
| `geo_opportunities`            | Cross-module GEO recommendations.           |

How you trigger a prompt depends on the client — in Claude Desktop and Claude Code they appear in the prompt or slash-command picker once the connector is authenticated.

For the full walkthrough and example questions, see [Get started with Share of Model MCP](/platform/getting-started/get-started-with-share-of-model-mcp).