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

# MCP Server

> Connect AI assistants to Caret using the Model Context Protocol

Caret exposes a Model Context Protocol (MCP) server that lets AI assistants access your workspace data — meeting notes, transcripts, knowledge base, and team info.

## Server Info

| Property  | Value                      |
| :-------- | :------------------------- |
| Name      | Caret MCP Server           |
| Version   | 1.0.0                      |
| Endpoint  | `https://api.caret.so/mcp` |
| Transport | Streamable HTTP            |

## Protocol Endpoints

| Method   | Path   | Description                             |
| :------- | :----- | :-------------------------------------- |
| `POST`   | `/mcp` | Execute MCP tool calls                  |
| `GET`    | `/mcp` | Get server metadata and available tools |
| `DELETE` | `/mcp` | Terminate session                       |

## Authentication

<CardGroup cols={2}>
  <Card title="OAuth 2.0 with PKCE" icon="shield-check" href="/api-reference/mcp/authentication">
    Recommended for interactive clients like Claude Desktop and Cursor. Most MCP
    clients handle this automatically.
  </Card>

  <Card title="API Key" icon="key" href="/api-reference/mcp/authentication#api-key-authentication">
    For programmatic access or clients that don't support OAuth.
  </Card>
</CardGroup>

## Available Tools

All tools are read-only and scoped to the authenticated workspace.

<CardGroup cols={2}>
  <Card title="Notes" icon="file-lines" href="/api-reference/mcp/tools#caret_list_notes">
    List, get, and search meeting notes with full transcripts and summaries.
  </Card>

  <Card title="Knowledge Search" icon="magnifying-glass" href="/api-reference/mcp/tools#caret_search_knowledge">
    Semantic search across meeting content and your workspace knowledge base.
  </Card>

  <Card title="Workspace" icon="building" href="/api-reference/mcp/tools#caret_get_workspace">
    Get workspace metadata including name, settings, and allowed domains.
  </Card>

  <Card title="Members" icon="users" href="/api-reference/mcp/tools#caret_list_members">
    List workspace members with roles and folder assignments.
  </Card>
</CardGroup>

## Discovery Endpoints

MCP clients can auto-discover server capabilities using these well-known endpoints:

| Endpoint                                          | Description                         |
| :------------------------------------------------ | :---------------------------------- |
| `GET /.well-known/oauth-authorization-server`     | OAuth authorization server metadata |
| `GET /.well-known/oauth-protected-resource`       | Protected resource metadata         |
| `GET /mcp/.well-known/oauth-authorization-server` | MCP-prefixed authorization metadata |
| `GET /mcp/.well-known/oauth-protected-resource`   | MCP-prefixed resource metadata      |
