Skip to main content
The hosted MCP server is at https://api.spiral.ai/mcp (Streamable HTTP). Connect to it either way:
  • Sign in, no API key. Give your agent the URL alone. Agents that support MCP sign-in register themselves, open Spiral’s sign-in in your browser, and you click Authorize. Leave any client ID, client secret or header fields empty.
  • With an API key. Send a key from API keys in the console as a bearer token, for CI or an agent without a browser:
Each tool is the REST endpoint it names, with the same scope and answer. A refusal (a disabled provider, a spend cap) comes back as a tool error with the REST error code, never as a broken connection.

Claude

One link and a sign-in, no key.

ChatGPT

One link and a sign-in, no key.

Muse

One message in the Muse app.

Grok

One link and a sign-in, no key.

OpenClaw

One command and a sign-in.

Hermes

One command and a sign-in.

Claude Code

One command and a sign-in.

Codex

One command and a sign-in.

Cursor

One click and a sign-in.

VS Code

One command and a sign-in.

Windsurf

One link and a sign-in.

Gemini CLI

One command and a sign-in.

Google Antigravity

One link and a sign-in.

opencode

One command and a sign-in.

Cline

One link and a sign-in.

Amp

One command and a sign-in.

goose

One link and a sign-in.

Grok Build

One command and a sign-in.

Muse Code

One command and a sign-in.

Devin

One command and a sign-in.

Factory Droid

One command and a sign-in.

Gemini

One link and a sign-in.

Perplexity

One link and a sign-in.

Instinct

One message and a key.

dots

One message and a key.

Your own agent

The CLI, MCP or REST.

Any agent

One line, from the skill.

Troubleshooting

Check the URL: exactly https://api.spiral.ai/mcp, with no trailing slash and no extra path. Remove the server, add it again, and allow pop-ups for the sign-in window. Leave client ID, secret and header fields empty.
The sign-in expired or was removed, or the API key is wrong or revoked. Sign in again from the agent (most have a login or authenticate command), or create a new key under API keys.
The agent waits for the sign-in on a local address on the machine it runs on. Forward that port to your computer (ssh -N -L <port>:127.0.0.1:<port> user@host), or use an API key instead.
Start a new chat or session so the agent loads Spiral’s tools, check that Spiral is turned on for that chat, and ask it to use Spiral by name.
The tool error carries the same code as the REST API: see errors. A disabled provider or a spend cap is set in the console.