Skip to content

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.

ActionClass
brands_listR
accounts_listR
posts_listR
posts_getR
posts_createW
posts_scheduleW*
posts_publishD
posts_cancelD
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: true
  • confirmationToken
  • expiresAt

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.

Continue with REST API or CLI.

Create your workspace, generate an API key in Settings → API, and connect your agent.

Start your 7-day trial