Skip to main content

MCP Server

Caesura provides an official Model Context Protocol (MCP) server, enabling any MCP-compatible client to securely access Caesura's deep psychological analysis engine.

By connecting to the Caesura MCP server, your AI agents or development environments (like Cursor or Claude Desktop) gain access to specialized tools for analyzing conversational dynamics and extracting actionable insights.

Server Details​

  • Endpoint: https://dev.caesura.io/api/mcp
  • Transport: Streamable HTTP (SSE / POST)
  • Protocol Version: MCP 0.1.0

Authentication​

The MCP server requires the same authentication as the rest of the Caesura API. You must provide a valid API key (or JWT) via the Authorization header.

Authorization: Bearer caesura_xxxxxx
note

See Authentication for more details on acquiring an API key.

Connecting an MCP Client​

The Caesura MCP Server works out-of-the-box with standard MCP clients like Claude Desktop, Cursor, and LM Studio. Because it uses the HTTP transport rather than stdio, you configure it as an SSE connection.

Example: Claude Desktop / Cursor​

Add the following to your MCP client configuration file:

{
  "mcpServers": {
    "caesura": {
      "url": "https://dev.caesura.io/api/mcp",
      "headers": {
        "Authorization": "Bearer caesura_your_key_here"
      }
    }
  }
}

(Note: Insert your real API key).

Programmatic Connection (Node.js)​

If you are using the official @modelcontextprotocol/sdk in Node.js to build a custom client, you connect using the SSEClientTransport:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

const transport = new SSEClientTransport(
  new URL("https://dev.caesura.io/api/mcp"),
  {
    headers: {
      Authorization: `Bearer ${process.env.CAESURA_API_KEY}`
    }
  }
);

const client = new Client(
  { name: "my-caesura-client", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

await client.connect(transport);

// List available Caesura tools
const tools = await client.listTools();
console.log(tools);

Available Tools​

Once connected, your client can invoke the tools exposed by the server. See the Tools page for detailed documentation on the currently implemented tools.

warning

Active Development The MCP server and its toolset are under active development and may change.