Model Context Protocol (MCP)
Outrun runs a Model Context Protocol (MCP) server that lets an AI client query your workspace data and manage workflows and agents. This page is for anyone connecting Claude Code or another MCP client to Outrun.
Server details
| Item | Value |
|---|---|
| Server URL | https://api.getoutrun.com/mcp |
| Transport | Streamable HTTP. Requests are POST with an Authorization: Bearer <token> header. |
| Authorization | OAuth 2.0 authorization code grant, with dynamic client registration |
| OAuth discovery | https://api.getoutrun.com/.well-known/oauth-authorization-server |
Connect a client
Add the server URL to your MCP client as a remote (HTTP) server. For Claude Code, run:
claude mcp add --transport http outrun https://api.getoutrun.com/mcp
For other clients, use the client's option for adding a remote MCP server and enter https://api.getoutrun.com/mcp.
When the client starts authorization, sign in to Outrun if asked. The consent screen then asks you to choose what the client can access:
- Under Capabilities, select what the client can do. You must select at least one.
- Under Data Sources, select connected sources. See the note under data types.
- Under Data Types, select the object types the client can read.
- Select Authorize, or Deny to cancel.
Capabilities
Each capability enables a set of tools.
| Capability on the consent screen | Scope | Tools it enables |
|---|---|---|
| Discover capabilities | action:discover |
get-capabilities, get-node-types, get-workflow-templates |
| Query data (read-only) | action:query |
execute-query, list-objects, get-object-count |
| Manage workflows | action:workflows |
list-workflows, create-workflow, start-workflow, build-workflow |
| Manage AI agents | action:agents |
list-agents, create-agent, update-agent-settings, attach-tool, detach-tool, run-agent, talk |
| View segments | action:segments |
list-segments |
| View destinations | action:destinations |
list-destinations |
| View knowledge bases | action:knowledge |
list-knowledge-bases |
A client may still list tools you did not grant. If it calls one, the call fails with This tool is not permitted by the current access scope.
Data types
| Data type on the consent screen | Scope |
|---|---|
| People | object:people |
| Organizations | object:organizations |
| Activities & Events | object:activities |
| Relationships | object:relationships |
list-objects returns only the data types you granted. Asking list-objects or get-object-count for another type fails with Access to object type "<type>" is not permitted by the current access scope. get-object-count called without a type counts every type.
Keep at least one data type selected. If you clear them all, the client is not limited by data type.
The Data Sources selection does not restrict which records a client can read.
Tool notes
execute-queryruns read-only GraphQL queries. It refuses any query that contains the wordmutation, with the errorOnly read-only queries are allowed. Mutations are not permitted.list-objectsreturns 1 to 100 objects per call. The default is 10.build-workflowreturns context your AI client uses to compose a workflow. It does not create a workflow. Usecreate-workflowto save one.
Rate limit
Outrun counts the requests each token sends. The count resets only after 60 seconds with no accepted request, so steady traffic keeps adding to it. When the count passes 200, Outrun returns HTTP 429 with the error code RATE_LIMIT_EXCEEDED. Wait 60 seconds, then retry.
Revoke access
Access does not expire. To revoke it, go to Settings > API Keys and delete the key named OAuth: <client name>. The client must authorize again to reconnect. To change what a client can access, delete its key and reconnect with different selections.
Troubleshooting
| Symptom | What to check |
|---|---|
| HTTP 401 | The request has no valid bearer token. Reconnect the client so it runs authorization again. |
This tool is not permitted by the current access scope. |
The tool needs a capability you did not grant. Revoke the key and reconnect with that capability. |
Access to object type ... is not permitted by the current access scope. |
The data type was not granted. Reconnect with that data type selected. |
| HTTP 429 | The token exceeded the rate limit. Wait 60 seconds. |