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

# MCP server overview for Spote

> Spote has a built-in MCP server at /sse and /mcp. Connect any MCP-compatible AI agent to save, search, and retrieve your notes from within a conversation.

Spote includes a built-in Model Context Protocol (MCP) server that lets any compatible AI agent interact with your notes. Agents can save notes, search them, and retrieve past context — without switching apps.

## Endpoints

Spote exposes two transport endpoints depending on what your AI client supports:

| Transport                | URL                              |
| ------------------------ | -------------------------------- |
| SSE (Server-Sent Events) | `https://your-spote-app.com/sse` |
| HTTP streaming           | `https://your-spote-app.com/mcp` |

Most modern MCP clients default to HTTP streaming (`/mcp`). Use `/sse` for clients that require SSE transport.

## Authentication

Agents authenticate using a Personal Access Token (PAT) as a Bearer token in the `Authorization` header:

```http theme={null}
Authorization: Bearer spote_<your-token>
```

You can generate a PAT from **Settings** in the Spote web app. See [Personal Access Tokens](/guides/personal-access-tokens) for step-by-step instructions.

## What agents can do

<CardGroup cols={2}>
  <Card title="Save notes" icon="floppy-disk">
    Tell your agent to save a note with a title, content, bucket, and tags. Spote indexes it immediately for semantic search.
  </Card>

  <Card title="Search semantically" icon="magnifying-glass">
    Ask your agent to find notes about a topic. Spote searches by meaning, not exact wording — so you find notes even when you don't remember the phrasing you used.
  </Card>

  <Card title="List & retrieve" icon="list">
    List your most recent notes or fetch the full content of a specific note by ID. Useful for pulling context into a conversation.
  </Card>

  <Card title="Manage notes" icon="pen-to-square">
    Update or delete notes from within a conversation. Your agent can reorganize, retitle, or remove notes without you opening the app.
  </Card>
</CardGroup>

## Supported AI tools

The Spote MCP server works with any client that supports the MCP protocol over SSE or HTTP streaming transport, including:

* **Claude Desktop** (Anthropic)
* **Cursor**
* **Windsurf**
* Any tool that implements the MCP protocol with SSE or HTTP transport

## Next steps

<CardGroup cols={2}>
  <Card title="Connect an AI agent" icon="plug" href="/connecting-ai-agents">
    Step-by-step setup for Claude Desktop, Cursor, and other MCP clients.
  </Card>

  <Card title="MCP tools reference" icon="code" href="/mcp/tools">
    Full reference for every tool your agent can call, with parameters and return values.
  </Card>
</CardGroup>