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:
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
The agent never asks me to sign in
The agent never asks me to sign in
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 browser cannot reach the sign-in callback (SSH, a server, a container)
The browser cannot reach the sign-in callback (SSH, a server, a container)
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.Connected, but the agent does not use Spiral
Connected, but the agent does not use Spiral
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.
A tool call fails with a code
A tool call fails with a code
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.
