We use cookies to enhance your experience and measure how the site performs. Choose "Essential Only" to disable analytics. Read our Privacy Policy.

    Odeus Docs

    Odeus Agent MCP Server

    Access your Odeus agents from any MCP-compatible AI client. The Odeus MCP Server exposes your workspace agents as MCP tools.

    Odeus Agent MCP Server

    Access your Odeus agents from any MCP-compatible AI client. The Odeus MCP Server exposes your workspace agents as MCP tools.

    The Odeus MCP Server exposes your Odeus agents as MCP tools, allowing any MCP-compatible AI client to interact with your workspace agents.

    What's this for?

    This lets external AI tools (like Claude Desktop, Cursor, or other MCP clients) call your Odeus agents directly. Your agents become tools that any MCP-compatible application can use.

    MCP Base URL

    The Odeus MCP server is available at https://api.odeus.ai/mcp.

    Authentication

    The MCP endpoint requires a valid Odeus API key with the Agent API scope.

    Make sure your API key has the Agent API scope enabled. Workspace-admins can create or manage API keys in your workspace settings.

    Supported Authentication Methods

    Header TypeHeader Format
    BearerAuthorization: Bearer <api-key>
    X-API-Keyx-api-key: <api-key>

    Available Tools

    The Odeus MCP Server exposes three tools:

    ToolDescription
    find_agentSearch for an agent ID by name
    ask_agentSend a prompt to an agent specified by its ID
    ask_custom_agentConfigure and query a custom agent on-the-fly

    find_agent

    Use this to look up an agent's ID when you only know its name. This is helpful when you want to call ask_agent but need to find the correct agent ID first.

    ask_agent

    Send a prompt to a specific agent using its ID. The agent processes your request using its configured model, instructions, and connected integrations.

    ask_custom_agent

    Create a temporary agent with custom settings for a single query. Useful when you need specific behavior without creating a permanent agent in Odeus.

    Connecting from Odeus

    If you want to add this MCP server as an integration within Odeus itself:

    Go to **Integrations** in your workspace settings.



Click **Add Integration** and select **MCP** as the integration type.



* **URL:** `https://api.odeus.ai/mcp`
* **Authentication method** API Key



* Click **Create and connect**
* Add a connection using a valid Odeus API key (must have `AGENT_API` scope)
* Set the **API Key Header Type** to *Authorization: Bearer*
* Click **Test connection** to verify access to the available tools

    Related Documentation