MCP Setup

Connect Chronary to your MCP client. You’ll need an API key from the Chronary console before starting.

Client setup

Add Chronary to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chronary": {
      "url": "https://api.chronary.ai/mcp",
      "headers": {
        "Authorization": "Bearer chr_sk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving. You should see a hammer icon indicating MCP tools are available.

Open Cursor Settings and navigate to the MCP section. Add a new server with these settings:

Name: chronary
Transport: Streamable HTTP
URL: https://api.chronary.ai/mcp

In your Cursor MCP configuration file (.cursor/mcp.json in your project root or global config):

{
  "mcpServers": {
    "chronary": {
      "url": "https://api.chronary.ai/mcp",
      "headers": {
        "Authorization": "Bearer chr_sk_your_key_here"
      }
    }
  }
}

Restart Cursor after saving. Chronary tools will appear in the agent tool list.

Install the MCP SDK:

npm install @modelcontextprotocol/sdk

Connect to Chronary:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({
  name: 'my-agent',
  version: '1.0.0',
});

const transport = new StreamableHTTPClientTransport(
  new URL('https://api.chronary.ai/mcp'),
  {
    requestInit: {
      headers: {
        Authorization: 'Bearer chr_sk_your_key_here',
      },
    },
  }
);

await client.connect(transport);

// List available tools
const { tools } = await client.listTools();
console.log(`Connected — ${tools.length} tools available`);

// Call a tool
const result = await client.callTool({
  name: 'list_agents',
  arguments: {},
});
console.log(result);

Install the MCP package:

pip install mcp

Connect to Chronary:

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async def main():
    async with streamablehttp_client(
        url="https://api.chronary.ai/mcp",
        headers={"Authorization": "Bearer chr_sk_your_key_here"},
    ) as (read_stream, write_stream, _):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            # List available tools
            tools = await session.list_tools()
            print(f"Connected — {len(tools.tools)} tools available")

            # Call a tool
            result = await session.call_tool("list_agents", arguments={})
            print(result)

import asyncio
asyncio.run(main())

Verify your connection

After setup, test that everything is working. Ask your AI client:

“List my agents”

The AI should call the list_agents tool and return results. If you haven’t registered any agents yet, you’ll see an empty list — that’s expected.

Confirm tools are visible

In Claude Desktop, click the hammer icon to see all available tools. You should see 21 Chronary tools listed.

In Cursor, check the agent tool list in the MCP settings panel.

For custom agents, call client.listTools() (TypeScript) or session.list_tools() (Python) and verify 21 tools are returned.

Register a test agent

Ask: “Register an AI agent called Test Agent”

The AI should call create_agent and return an agent with an agt_ prefixed ID.

Create a calendar and event

Ask: “Create a calendar called ‘Demo Calendar’ in UTC for that agent, then add a meeting tomorrow at 2pm”

The AI should call create_calendar followed by create_event.

Verify via REST (optional)

Confirm the data is shared by querying the REST API:

curl https://api.chronary.ai/v1/agents \
  -H "Authorization: Bearer chr_sk_your_key_here"

You should see the same agent and calendar created via MCP.

Troubleshooting

| Problem | Solution | |---|---| | Tools not appearing | Restart your client after editing the config file. Check for JSON syntax errors. | | 401 Unauthorized | Verify your API key is correct and includes the Bearer prefix. | | 403 Forbidden | Your API key may be deactivated. Check the console. | | Connection timeout | Ensure you can reach api.chronary.ai from your network. Check firewall/proxy settings. | | Tool call returns error | Check the error message — it follows the same error format as the REST API. |

Next steps

Tools Reference All 21 tools with parameters and examples

MCP Overview Architecture, transport, and how MCP relates to REST

Authentication Test vs live keys, key rotation, and scopes