API Reference

Connections

Give agents external reach through native integrations and MCP servers.

Connections are how an agent reaches the outside world. They come in two forms:

  • Integrations — native connectors to services such as HubSpot, Salesforce, Google Sheets, and Gmail, authorized once per project via OAuth.
  • MCP servers — Model Context Protocol servers that expose tools an agent can call, including Rightbrain-hosted and third-party servers.

This section also covers Slack installations and channel mappings, the agent-scoped MCP endpoints (Agent MCP Servers and Agent MCP Tools), and MCP Runs for auditing tool calls.

All endpoints are scoped to an organization and project and require a bearer token or OAuth client credentials. See Authentication.

Key endpoints

POST
/api/v1/org/:org_id/project/:project_id/mcp_server
1curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/mcp_server \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "name": "acme-analytics-postgres",
6  "url": "https://analytics-mcp.acme-logistics.com",
7  "description": "Read-only MCP access to the analytics warehouse for reporting queries."
8}'
Try it
MethodEndpointPurpose
GETIntegration catalogList the integrations available to connect.
POSTAuthorize integrationStart the OAuth flow for an integration; companion endpoints report status or disconnect it.
POSTCreate MCP serverRegister an MCP server for the project, then list, update, or delete it.
GETMCP run historyAudit the tool calls made through MCP servers, with per-run detail.
POSTConnect SlackConnect a Slack workspace, then map channels to agents to trigger runs.