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

# MCP server

> Connect Claude, ChatGPT, Cursor, VS Code and other AI clients to your Quotable workspace over the Model Context Protocol, with OAuth sign-in or an API key, and ask about your AI visibility in plain language.

The Quotable MCP server lets an AI client read your workspace's data directly. Ask your assistant how your brand's visibility moved this month, which competitors AI answers name instead of you, or which sources they cite, and it answers from your tracking data rather than from memory.

[Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open standard for connecting AI applications to outside tools and data. Quotable runs a remote MCP server; your client connects to it over HTTPS and either signs in to Quotable with OAuth or sends a Quotable API key.

## What you can do

> [card] Track visibility
>
> Daily visibility score, mention rate and share of voice for each brand, over any range up to 366 days.

> [card] Compare competitors
>
> Share of voice covers every brand named in AI answers, tracked or discovered, so you can see who is winning each day.

> [card] Find the sources AI cites
>
> The pages AI engines cite for your prompts, most cited first, with how often each was cited and retrieved.

> [card] Plan around demand
>
> Your tracked prompts and the AI question volume behind your topics.

> [card] See ChatGPT shopping
>
> The products ChatGPT recommends for your prompts, and how each one performs.

> [card] Use agents and tables
>
> Read your agents and tables, and start an agent run when you ask for one.

Thirteen of the server's 14 tools only read data. The exception is `run_agent`, which starts an agent run and uses your workspace's credits. It needs the `run:agents` scope, and most clients ask you before calling it. No tool deletes anything. See [Tools](https://docs.usequotable.com/mcp-server/tools.md) for the full reference.

## Connection details

| | |
| - | - |
| **Server URL** | `https://app.usequotable.com/api/mcp` |
| **Transport** | Streamable HTTP, JSON responses |
| **Authentication** | OAuth sign-in, or `Authorization: Bearer quotable_live_…` (a Quotable API key) |
| **OAuth** | Supported: dynamic client registration, client metadata documents, PKCE (S256), refresh tokens |
| **Server name** | `quotable` |
| **Tools** | 14: 13 read-only, plus `run_agent` |
| **Rate limit** | 300 requests per minute per connection or key; a key shares its limit with the REST API |

Signing in with OAuth is the easiest way to connect Claude, ChatGPT and Claude Code: you approve the connection in Quotable and the client handles the rest. API keys work with any client that can send a header, and they're the same keys, scopes and rate limit as the [REST API](https://docs.usequotable.com/api-reference/introduction.md). See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md) for both.

## How it works

**1. Add the server to your AI client**

Add `https://app.usequotable.com/api/mcp` as a remote MCP server. Pick your client below.

**2. Sign in, or send a key**

If your client signs in with OAuth, a Quotable page opens: choose the workspace, the data and the brands the client may read, then click **Allow access**. Otherwise create a key in **Settings → API keys** and send it in the `Authorization` header. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md).

**3. Ask a question**

Ask about your brand in plain language. Your assistant calls `list_projects` to find your brands, then the tools it needs to answer. Try the [example prompts](https://docs.usequotable.com/mcp-server/example-prompts.md).

## Connect your client

| Client | How it connects |
| - | - |
| Claude (claude.ai, Desktop, mobile) | OAuth sign-in from a custom connector |
| ChatGPT | OAuth sign-in from a developer mode app |
| Claude Code | OAuth sign-in, or an API key header |
| Cursor, VS Code, Windsurf, Gemini CLI | API key header |
| Other clients | OAuth if the client supports MCP sign-in, otherwise an API key header |

> [card] [Claude Code](https://docs.usequotable.com/mcp-server/connect/claude-code.md)
>
> One command with `claude mcp add`, then sign in.

> [card] [Claude Desktop and claude.ai](https://docs.usequotable.com/mcp-server/connect/claude-desktop.md)
>
> Custom connector with OAuth sign-in.

> [card] [Cursor](https://docs.usequotable.com/mcp-server/connect/cursor.md)
>
> `mcp.json`, global or per project.

> [card] [VS Code](https://docs.usequotable.com/mcp-server/connect/vscode.md)
>
> `mcp.json` with a masked key prompt.

> [card] [Windsurf](https://docs.usequotable.com/mcp-server/connect/windsurf.md)
>
> `mcp_config.json` in Windsurf, now Devin Desktop.

> [card] [Gemini CLI](https://docs.usequotable.com/mcp-server/connect/gemini-cli.md)
>
> `gemini mcp add` or `settings.json`.

> [card] [ChatGPT](https://docs.usequotable.com/mcp-server/connect/chatgpt.md)
>
> Developer mode app with OAuth sign-in.

> [card] [Other clients](https://docs.usequotable.com/mcp-server/connect/other-clients.md)
>
> OAuth discovery, custom headers, or raw JSON-RPC.

## Next steps

> [card] [Tools reference](https://docs.usequotable.com/mcp-server/tools.md)
>
> Inputs, outputs and scopes for every tool.

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Multi-step recipes, from a weekly brief to an agent run.

> [card] [Troubleshooting](https://docs.usequotable.com/mcp-server/troubleshooting.md)
>
> Errors and what they mean.


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