MCP

Expose your Rightbrain tasks and agents as tools that any MCP client can call.

Rightbrain speaks the Model Context Protocol (MCP), the open standard for connecting AI applications to external tools. This page covers the outbound direction: turning your Rightbrain tasks and agents into MCP tools that external clients discover and run.

Two directions, one protocol. This page is about exposing Rightbrain as an MCP server so tools like Claude and Cursor can call your work. For the other direction, where a Rightbrain agent connects out to an external MCP server as a client, see Connections.

What you get

When you expose a task over MCP, it becomes discoverable and runnable by any MCP-compatible client, including Claude.ai, Cursor, and Windsurf. The client sees your task as a native tool. It calls the tool, Rightbrain runs the task on your configured model with your prompt and schema, and returns the structured result.

Without MCPWith MCP
Callable only through your appCallable from any MCP-enabled client
Requires manual API integrationDiscovered automatically by the client
One integration surfaceReused across every MCP client you connect

Expose a task over MCP

A task is served over MCP once it’s flagged for agent exposure and you have an API key for clients to authenticate with. Both are set through the API (or the dashboard).

1

Flag the task for exposure

Set the task’s exposed_to_agents flag. The MCP gateway advertises every exposed task in the project as a callable tool.

2

Provision an API key

Mint or select an API key in the project. MCP clients present this key as a bearer token, so the task runs with that key’s project permissions.

3

Connect from your client

Add Rightbrain’s gateway URL as an MCP server in any MCP-compatible client (Claude, Cursor, Windsurf). The task appears as a native tool, backed entirely by your Rightbrain configuration.

The MCP gateway

Under the hood, exposed tasks and agents are served through Rightbrain’s MCP gateway over Streamable HTTP. Clients that let you add a server by URL connect to the project-scoped gateway endpoint:

POST https://app.rightbrain.ai/api/v1/{project_id}/mcp

Authenticate with the API key you selected when enabling MCP, sent as a bearer token:

Authorization: Bearer <your-api-key>

The gateway advertises each enabled task as a tool. Tool calls run the task and stream results back to the client.

Next steps