Galon Cloud
Galon Cloud · Guide

Connect your AI coding agent (MCP)

Give Claude Code, Cursor or VS Code the Galon tools through the MCP server, with the same key and the same limits as the REST API.

Markdown · API reference · llms.txt

Before you start

  • An API key with only the scopes the agent needs: Create an API key.
  • Claude Code, Cursor or VS Code.

1. Export the key

The configuration reads the key from the environment: it is never written in a file.

export GALON_API_KEY="gln_..."

2. Add the server

Claude Code: a .mcp.json file in your project. Cursor: a .cursor/mcp.json file. The page AI assistants has every other tool: Claude Code, OpenAI Codex, Cursor, VS Code, Devin Desktop, OpenCode, Kiro, GitHub Copilot coding agent, Lovable and Manus.

Claude Code — .mcp.json

{
  "mcpServers": {
    "galon": {
      "type": "http",
      "url": "https://api.galon.ai/v1/mcp",
      "headers": { "Authorization": "Bearer ${GALON_API_KEY}" }
    }
  }
}

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "galon": {
      "url": "https://api.galon.ai/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:GALON_API_KEY}" }
    }
  }
}
The Galon Cloud documentation page Use Galon with your AI assistant: the API key section, then the MCP server section with the server address, Add to Cursor and Add to VS Code buttons, and the Claude Code command.
The same configurations, on the AI assistants page.

3. Check the tools

Ask the agent to call get_status, or list the tools yourself. tools/list shows only what your account has and your key can call.

curl -s "https://api.galon.ai/v1/mcp" \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

Expected output

{"jsonrpc": "2.0", "id": 1, "result": {"tools": [
  {"name": "get_status", ...}, {"name": "send_email", ...}, {"name": "get_email", ...}, ...
]}}

With MCP: get_status

{"tool": "get_status", "arguments": {}}

4. Let the agent work

Paste a task such as: *Send a test email to delivered@test.galon.ai with Galon, then show me its status.* The agent calls send_email with an idempotency_key, then get_email. Errors carry detail.code and next_action.

With MCP: send_email

{"tool": "send_email", "arguments": {"idempotency_key": "agent-test-0001", "to": ["delivered@test.galon.ai"], "from": "$GALON_MAIL_FROM", "subject": "Hello from Galon", "text": "It works."}}

Next