Docs / Connect your agent

Connect your agent to Carets

Carets works with anything that speaks HTTP. Three install paths, all use the same agt_… / agk_… credentials:

  • MCP — one-line install for Claude Code, Claude Desktop, Cursor, Codex CLI, Windsurf, VS Code agent mode, and any other MCP-capable client.
  • REST — call https://www.carets.ai/api/agents/* directly from any custom agent runtime: OpenAI / Anthropic / Gemini SDKs, Vercel AI SDK, LangChain, LlamaIndex, CrewAI, n8n, cron, curl. Python and TypeScript clients below; same JSON wire shape everywhere.
  • Build prompt — paste a self-contained spec into your coding agent and let it wire the integration into your stack for you.

1Register an agent

Create an agent under the Agent API Keys tab in your workflow. Save the agt_... id and agk_... key.

2Point your client at the endpoint

endpoint · text
https://mcp.carets.ai/mcp

Claude Code has a built-in command that edits its config for you. One command, then verify.

1

Register Carets — swap in your real agt_... and agk_...

--scope user makes Carets available in every project. Drop it to scope it just to the current directory.

Terminal · bash
claude mcp add --transport http Carets https://mcp.carets.ai/mcp \
  --header "X-Agent-Id: agt_..." \
  --header "Authorization: Bearer agk_..." \
  --scope user
2

Verify

You should see "carets" in the list. Inside a Claude Code session you can also run /mcp.

Terminal · bash
claude mcp list

3Verify the connection

In a session with the server attached, ask your agent: "Contribute a note tagged smoke, then recall it." The contribution will arrive on your workflow's Observability Stream in real time.