Connect MCP

Connect Docs MCP for documentation search and API MCP for Straddle requests. If you want integration skills too, install the Straddle plugin, which includes both connections.

Before you start

Use a client that supports remote HTTP MCP servers. For API requests, get a sandbox API key from the Straddle dashboard and supply it as STRADDLE_API_KEY in the environment that starts your client. Restart the client after setting the variable. A desktop app must inherit the variable in its own process, including when you open it outside a terminal. Docs MCP needs no credential, so you can connect it independently.

Add the servers

Choose your client. For documentation search alone, add only the straddle-docs entry or command.

Claude Code
Codex
Cursor
VS Code

From your project directory, register both servers in local scope:

claude mcp add --transport http --scope local \
  straddle-docs \
  https://straddle-build-straddle-openapi.apidocumentation.com/mcp

claude mcp add --transport http --scope local \
  straddle-api \
  https://mcp.scalar.com/mcp/d5d1b1c2-ae5b-432d-b795-4fcb31cfdedd \
  --header 'Authorization: Bearer ${STRADDLE_API_KEY}'

Keep the single quotes around the header so Claude Code receives the variable reference. Start Claude Code from that environment, enter /mcp, and confirm both connections.

codex mcp add straddle-docs \
  --url https://straddle-build-straddle-openapi.apidocumentation.com/mcp

codex mcp add straddle-api \
  --url https://mcp.scalar.com/mcp/d5d1b1c2-ae5b-432d-b795-4fcb31cfdedd \
  --bearer-token-env-var STRADDLE_API_KEY

Check the configuration before starting a new session:

codex mcp list --json

Confirm both server URLs and bearer_token_env_var: "STRADDLE_API_KEY" for straddle-api.

Open ~/.cursor/mcp.json for a personal connection, or .cursor/mcp.json for a project connection. Merge these entries into the existing mcpServers object:

{
  "mcpServers": {
    "straddle-docs": {
      "url": "https://straddle-build-straddle-openapi.apidocumentation.com/mcp"
    },
    "straddle-api": {
      "url": "https://mcp.scalar.com/mcp/d5d1b1c2-ae5b-432d-b795-4fcb31cfdedd",
      "headers": {
        "Authorization": "Bearer ${env:STRADDLE_API_KEY}"
      }
    }
  }
}

In Customize, confirm both servers are enabled and their tools appear. For additional options, see Cursor’s MCP guide.

In the Command Palette, select MCP: Open User Configuration. For a project connection, open .vscode/mcp.json. Merge these entries into the existing servers object:

{
  "servers": {
    "straddle-docs": {
      "type": "http",
      "url": "https://straddle-build-straddle-openapi.apidocumentation.com/mcp"
    },
    "straddle-api": {
      "type": "http",
      "url": "https://mcp.scalar.com/mcp/d5d1b1c2-ae5b-432d-b795-4fcb31cfdedd",
      "headers": {
        "Authorization": "Bearer ${env:STRADDLE_API_KEY}"
      }
    }
  }
}

Select MCP: List Servers, choose each server, and select Start. Review the server trust prompt. In chat, open Configure Tools and confirm the tools appear.

Verify each connection

Search documentation

Ask your agent to query Docs MCP:

Check Straddle documentation search.

Expect a relevant documentation result with a source link.

Discover the API

Ask for a specification summary:

Check API MCP discovery.

Expect a specification summary. This checks discovery; read a sandbox account to verify an authenticated request.

For connection or authentication errors, follow MCP troubleshooting.

Get started

Straddle Wizard

Agent skills

Playbooks

Straddle MCP

Straddle CLI

SDKs

Before you start

Add the servers

Verify each connection

​Before you start

​Add the servers

​Verify each connection

Before you start

Add the servers

Verify each connection