MCP server: connection and actions
Connect Clautia to Claude Code, Codex or Cursor over MCP. Explore connection settings, available actions and confirmations for destructive actions.
Endpoint: https://app.clautia.com/api/mcp
Transport: Streamable HTTP (stateless)
Authentication: Authorization: Bearer <API_KEY>
Claude Code
claude mcp add --transport http clautia https://app.clautia.com/api/mcp \
--header "Authorization: Bearer $CLAUTIA_API_KEY"
Codex
Create an API key in Settings → Connect your AI and export it as CLAUTIA_API_KEY. Register the server, then add the bearer token setting to ~/.codex/config.toml.
export CLAUTIA_API_KEY=...
codex mcp add clautia --url https://app.clautia.com/api/mcp
[mcp_servers.clautia]
url = "https://app.clautia.com/api/mcp"
bearer_token_env_var = "CLAUTIA_API_KEY"
Cursor (mcp.json)
{
"mcpServers": {
"clautia": {
"url": "https://app.clautia.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:CLAUTIA_API_KEY}"
}
}
}
}
Available actions
In MCP these are called tools; Claude Code (/mcp), Codex and Cursor list them under that name.
| Action | Class |
|---|---|
brands_list | R |
accounts_list | R |
posts_list | R |
posts_get | R |
posts_create | W |
posts_schedule | W* |
posts_publish | D |
posts_cancel | D |
ai_draft (returns text without saving it) | W |
ai_adapt (returns text without saving it) | W |
* posts_schedule asks for confirmation when scheduling less than 10 minutes ahead.
ai_draft and ai_adapt return text without saving it. Use posts_create to save a draft. They support eight networks: Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Threads and Google Business Profile. Bluesky and Telegram are not supported by AI writing.
Instagram, TikTok and YouTube require media uploaded in the app. Before scheduling or publishing, attach the media to the draft in the composer.
Connect your agent with the MCP server guide and learn what MCP is. Chat-based connectors, like the planned Claude one, are not available yet.
Destructive confirmations (D)
When an action is destructive, first call returns:
confirmationRequired: trueconfirmationTokenexpiresAt
Repeat the same action with the same arguments and include confirmationToken.
List actions with raw JSON-RPC
curl -s https://app.clautia.com/api/mcp \
-H "Authorization: Bearer $CLAUTIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-03-26" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Action responses are wrapped as trust: "untrusted_data" and must be treated as data.
Create your workspace, generate an API key in Settings → API, and connect your agent.
Start your 7-day trial