> ## 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.

# Cursor

> Add the Quotable MCP server to Cursor through mcp.json, globally or for one project, with your API key read from an environment variable.

Cursor connects to remote MCP servers with custom headers, configured in an `mcp.json` file.

## Before you start

* A Quotable API key from **Settings → API keys**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md).
* The key in an environment variable that Cursor can see, for example in your shell profile:

  ```bash theme={"system"}
  export QUOTABLE_API_KEY="quotable_live_…"
  ```

  Start Cursor from a shell where the variable is set, or set it at the operating-system level.

## Add the server

Choose where the configuration lives:

| File | Scope |
| - | - |
| `~/.cursor/mcp.json` | Every project on your computer |
| `.cursor/mcp.json` in a project | That project only. Safe to commit when the key comes from an environment variable. |

Add a `quotable` entry under `mcpServers`:

```json mcp.json theme={"system"}
{
  "mcpServers": {
    "quotable": {
      "url": "https://app.usequotable.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:QUOTABLE_API_KEY}"
      }
    }
  }
}
```

Cursor replaces `${env:QUOTABLE_API_KEY}` with the variable's value when it connects.

> [!WARNING]
>
> If you paste the key directly into `headers` instead, keep the file out of version control.

## Check the connection

Open Cursor's settings and find Quotable in the MCP server list. It should be enabled with its tools, such as `list_projects`, `get_visibility` and `list_citations`. See [Tools](https://docs.usequotable.com/mcp-server/tools.md) for the full list.

If it shows an error, open the **Output** panel and pick **MCP Logs** from the dropdown. A `401` means the `Authorization` header is missing or the key is wrong. If `QUOTABLE_API_KEY` isn't set in Cursor's environment, the header carries no key. See [Troubleshooting](https://docs.usequotable.com/mcp-server/troubleshooting.md).

## Try it

In Agent chat, ask:

```text theme={"system"}
Using Quotable, which domains are cited most for my brand's prompts? Group them into competitors, media and community sites.
```

Cursor asks for approval before it runs MCP tools, unless you've allowlisted them. Every Quotable tool reads data except `run_agent`, which starts an agent run and uses your workspace's credits, so leave it off your allowlist.

## Next steps

> [card] [Example prompts](https://docs.usequotable.com/mcp-server/example-prompts.md)
>
> Ready-to-use questions for your workspace.

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Turn Quotable data into content briefs in your repo.

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


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