MCP

Connect Siesta AI to any MCP-compatible AI client (Claude, Cursor, VS Code, Antigravity, and others). Once connected, the client can manage your agents, skills and workflows, send messages, and read conversations directly from your Siesta AI organization.

How to install

Add one of the connection definitions below to your AI client's MCP configuration. Replace [YOUR-API-KEY] and [YOUR-ORGANIZATION-KEY] with the values from your Siesta AI organization.

HTTP

Recommended. No external dependencies, though a few clients may not support it yet.

"siesta": {
  "type": "http",
  "url": "https://api.siesta.ai/mcp",
  "headers": {
    "X-Api-Key": "[YOUR-API-KEY]",
    "X-Org-Id": "[YOUR-ORGANIZATION-KEY]"
  }
}

npx (fallback)

Needs Node.js. Use only as a fallback when the client cannot connect over HTTP.

"siesta": {
  "command": "npx",
  "args": [
    "-y", "mcp-remote", "https://api.siesta.ai/mcp",
    "--header", "X-Api-Key:[YOUR-API-KEY]",
    "--header", "X-Org-Id:[YOUR-ORGANIZATION-KEY]"
  ]
}

Easiest way to install

Every AI provider (Claude, Antigravity, and others) stores MCP servers differently and expects these definitions in its own JSON config. The fastest path is to copy the JSON above (with your API key and organization ID from Siesta AI), paste it into the client's chat, and ask the AI to install it. Then follow any instructions it gives, for example restarting the client to refresh the MCP tools.

OAuth installation

Coming soon

OAuth-based installation is in progress.

Tools

Once connected, the client can use the tools below. All operate within the organization identified by your API key and organization ID.

Agents

Tool	Description
list_agents	List the agents (chatbots) in your organization. Use it to find an agent's ID before messaging or editing it.
get_agent	Read an agent's full configuration: system message, model, connection, skills, sub-agents and tools.
create_agent	Create a new agent from a name and system message, optionally attaching a model, skills, sub-agents and tools.
update_agent	Update an existing agent. Only the fields you pass change; list fields replace the whole set.

Conversations

Tool	Description
send_message	Send a message to an agent and get its reply. Pass an agentId to start a new conversation or a conversationId to continue one.
list_conversations	List existing conversations (newest first), with optional filtering by agent or title search and paging.
get_conversation	Read the full message history of a conversation before resuming it.

Skills

Tool	Description
list_skills	List the skills (named instructions plus bound tool functions) available in your organization.
get_skill	Read a skill's full detail: its instructions and bound functions.
create_skill	Create a new skill from a name, instructions and optional bound functions.
update_skill	Update an existing skill. Only the fields you pass change; passing functions replaces the whole set.
list_skill_functions	List the tool functions that can be bound to a skill, returning the IDs to use when creating or updating one.

Workflows

Tool	Description
list_workflows	List the workflows in your organization. Use it to find a workflow's ID before reading or editing it.
get_workflow	Read a workflow's full graph: nodes (with IDs, types and input mappings) and edges.
create_workflow	Create a workflow from a full graph of nodes and edges in one call.
update_workflow	Replace a workflow's graph with the full set of nodes and edges it should have.
describe_node_types	Discover the workflow building blocks (node types, their inputs/outputs and selectable targets) before building a workflow.
list_workflow_functions	Search the tool functions that can back a workflow tool node, filtered by provider or capability.

Discovery

Tool	Description
list_connections	List the connections (integrations) available as an agent's model provider or as a tool.
list_models	List the LLM models available for an agent, optionally filtered by connection.
list_system_tools	List the built-in system tools (for example web grounding and scraping) that can be enabled on an agent.