Theona Main Logo
In this article
3 min

Theona Is Now Available via MCP

Theona now has an MCP server. MCP (Model Context Protocol) is an open standard that lets any AI client connect to any AI service through a single interface. Connect Theona to Claude Desktop, Claude Code, Cursor, Windsurf, or any other MCP-compatible client. Run your agents from wherever you already work.

MCP turns Theona into a layer inside your AI assistant. Claude, Cursor, or Windsurf can call your agents the same way they read a file or search the web. Your agents stop being a separate destination. They become part of the conversation.

What You Can Do Through MCP

Your agents, from any client

Once connected, your MCP client gets direct access to Theona’s agent layer.

Available operations:

  • List the agents in your workspace
  • Run any agent
  • Send input mid-run, for passing parameters or continuing a conversation
  • Check the status of a running job
  • Cancel a run

The full interaction loop, from any MCP client. No browser tab required.

How to Connect

Claude Desktop

  1. Open Customize → Connectors → ”+” → Add custom connector
  2. Set the Remote MCP Server URL to https://api.theona.ai/mcp
  3. Click Add, then allow access when your browser prompts you

Claude Desktop may not update the connector’s status immediately. If the status looks stale, reopen the app.

Claude Code

Add the Theona server:

claude mcp add --transport http theona https://api.theona.ai/mcp

Then authenticate:

  1. Run Claude Code
  2. Type /mcp
  3. Select Theona from the list
  4. Select Authenticate
  5. Allow access when your browser prompts you

Cursor

Add the following to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-specific):

{
  "mcpServers": {
    "theona": {
      "url": "https://api.theona.ai/mcp"
    }
  }
}

Cursor will prompt you to authenticate with Theona the first time it connects.

Windsurf

Open Windsurf Settings → Cascade → MCP Servers, add a server, set the type to HTTP/SSE, and enter https://api.theona.ai/mcp as the server URL. Authenticate when prompted.

Or add to your Windsurf MCP config file:

{
  "mcpServers": {
    "theona": {
      "serverUrl": "https://api.theona.ai/mcp"
    }
  }
}

Other MCP-Compatible Clients

Any client that supports remote MCP servers over HTTP transport can connect to Theona. The server URL is always https://api.theona.ai/mcp. Check your client’s documentation for where to add remote servers.

Why This Matters to Us

Meet people where they work

Theona is built around one idea: AI agents should fit into how people already work. MCP is the clearest expression of that at the infrastructure level. A standard that lets tools talk to each other without someone building a custom bridge every time.

Making Theona available as an MCP server is part of a longer commitment. Your agents should work wherever you do. The AI industry is converging on open standards. We intend to be wherever those standards land.

The server is live at https://api.theona.ai/mcp. Pick your client, add the URL, and your agents are ready.