Skip to main content
Install the Straddle plugin to help your agent plan, build, and test a Straddle integration. The plugin includes Straddle skills and connections to the hosted Docs MCP and API MCP servers.

​
Before you start

Prepare the following:
  • Your coding client: Claude Code or Codex with plugin commands available, or Cursor with team marketplace access.
  • Node.js 22.18 or later: Required for the Straddle Wizard commands on this page.
  • A sandbox API key: Get one from the Straddle dashboard to use the API MCP. Docs MCP needs no key.
For Claude Code and Codex, set STRADDLE_API_KEY through your secret manager or shell environment before starting the client. Desktop apps must inherit the variable in their own process. Cursor’s plugin has a field for the key in Configure.

​
Install for your client

Choose your client and complete its steps. The Straddle Wizard downloads a released plugin, verifies its checksum, and registers it with Claude Code or Codex. Cursor installs through its team marketplace.
1

Install the plugin

From your project directory, run the installer and confirm its download and installation prompts:
The Wizard installs straddle@straddle in user scope, including both MCP server declarations.
2

Verify the installation

Check the installed plugin and the Wizard’s verification result:
Confirm that straddle@straddle is enabled. In the Wizard output, find the claude entry in clients and confirm plugin.state is installed and plugin.verified is true.Start a new Claude Code session, then enter /mcp. Confirm that the plugin’s straddle-api and straddle-docs servers connect.

​
Check the connection

Ask your agent to use the API MCP’s specification summary tool:

Summarize the Straddle API specification.

Expect a summary of the API specification. This verifies the MCP connection and specification access. Setup checks API key configuration separately. API MCP connects to https://mcp.scalar.com/mcp/d5d1b1c2-ae5b-432d-b795-4fcb31cfdedd. Its execute-request tool runs Straddle API operations with your key, including writes. Keep your client’s tool approval prompts enabled so you can review each request.

​
Run Setup

In your project directory, select the sandbox environment and start the Straddle Wizard’s Setup workflow:
Choose your client and Auto to run the workflow in your terminal, or Manual for a prompt to paste into your agent. Setup checks your project, CLI, SDK, environment, and MCP connections, then writes straddle-setup.md with the results and next actions.

​
Install skills in another client

For a client supported by the skills installer, install the skills and choose your client when prompted:
This route copies the skills into your client. Add MCP connections separately using Connect MCP.

​
Update or remove the plugin

For a Wizard-managed installation, use the matching client name. For example, update Claude Code’s plugin:
Replace claude with codex for Codex. Restart your client, then repeat its verification steps. To remove the plugin and its marketplace, run:
For Codex, use --client codex. To also remove the client-level Straddle MCP entries, run npx @straddlecom/wizard@latest mcp remove --client codex. In Cursor, refresh the team marketplace to update, or enable Auto Refresh. To remove the installation, uninstall Straddle, then remove the marketplace if your team no longer uses it.