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:

  1. Under Capabilities, select what the client can do. You must select at least one.
  2. Under Data Sources, select connected sources. See the note under data types.
  3. Under Data Types, select the object types the client can read.
  4. 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-query runs read-only GraphQL queries. It refuses any query that contains the word mutation, with the error Only read-only queries are allowed. Mutations are not permitted.
  • list-objects returns 1 to 100 objects per call. The default is 10.
  • build-workflow returns context your AI client uses to compose a workflow. It does not create a workflow. Use create-workflow to 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.