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

# MCP Overview

> Connect your Along account to Claude, ChatGPT, or any MCP-compatible AI assistant.

Along's MCP server exposes your Safes as tools to any MCP-compatible AI assistant. Once connected, the assistant can list your Safes, select an active Safe, and query its knowledge graph — all from within the conversation.

## MCP endpoint

Along provides two endpoint variants depending on how you want to scope access:

| Variant     | Endpoint                | Description                                                            |
| ----------- | ----------------------- | ---------------------------------------------------------------------- |
| User-scoped | `POST /mcp/v1`          | Access is tied to your user account; Safe selection happens at runtime |
| Safe-scoped | `POST /mcp/v1/{safeId}` | Access is pinned to a specific Safe at the token level                 |

For most integrations — including Claude and ChatGPT — you'll use the user-scoped endpoint `https://along-api-qrd5m37v3a-ey.a.run.app/mcp/v1`) and select your Safe during the OAuth authorization flow or from within the conversation.

## Authentication

All MCP requests require a Bearer token obtained through Along's [OAuth 2.0 PKCE flow](/mcp/oauth-flow). The token is issued after you authorize the connection in the Along consent page.

```text theme={null}
POST /mcp/v1
Authorization: Bearer avo_...
Content-Type: application/json
```

## Protocol

Along's MCP server implements the **MCP 2025-03-26** protocol using JSON-RPC 2.0 over HTTP. Requests are standard JSON-RPC method calls; responses are synchronous JSON objects.

## Available tools

After connecting, the following tools are available to the AI assistant:

| Tool                | Description                                  |
| ------------------- | -------------------------------------------- |
| `along_list_safes`  | Lists all Safes your account has access to   |
| `along_select_safe` | Sets the active Safe for the current session |
| `along`             | Queries the active Safe's knowledge graph    |

## Get started

<CardGroup cols={2}>
  <Card title="OAuth Flow" href="/mcp/oauth-flow">
    Understand how Along's OAuth 2.0 PKCE authorization works and how tokens are issued.
  </Card>

  <Card title="Connect to Claude" href="/mcp/connecting-claude">
    Add Along as an MCP server in Claude and start querying your Safes from conversations.
  </Card>

  <Card title="Connect to ChatGPT" href="/mcp/connecting-chatgpt">
    Add Along as a connector in ChatGPT and query your knowledge graph directly.
  </Card>

  <Card title="MCP Tools" href="/mcp/tools/along">
    Explore the full reference for Along's MCP tools and their parameters.
  </Card>
</CardGroup>