Installation

You do not install an npm package. Point your MCP client at the hosted server and send your API key on every request.

Endpoint

https://mcp.actionflows.ai

Transport is Streamable HTTP (JSON). Authenticate every request.

Authentication

Use the same API key as the REST API. Pass it as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Create and rotate keys from Organization → API Keys.

Failed auth returns HTTP 401 with WWW-Authenticate: Bearer.

Organization-scoped keys inherit their organization. User-scoped keys should pass organizationId on tools that need it.

Cursor

{
  "mcpServers": {
    "actionflows": {
      "url": "https://mcp.actionflows.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http actionflows https://mcp.actionflows.ai --header "Authorization: Bearer YOUR_API_KEY"

VS Code

{
  "servers": {
    "actionflows": {
      "type": "http",
      "url": "https://mcp.actionflows.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Shared tool arguments

Every tool accepts optional response_format:

Successful calls also return structuredContent for clients that use it.

List tools that paginate with limit / offset default to 50 items (limit 1-100). has_more and next_offset tell you when to continue.

Results larger than 25,000 characters are truncated. Add filters or a smaller limit / pageSize.

Rate limits

Per-user rate limiting applies in addition to IP limits. HTTP 429 means wait and retry.

Next

• ActionFlows
• Runs
• Action Agents
• API Introduction