# 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.

Estimated time: 3 minutes.

## Before you start

- An API key with only the scopes the agent needs: [Create an API key](/cloud/docs/guides/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.

```bash
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](/cloud/docs/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**

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

**Cursor — .cursor/mcp.json**

```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.](/cloud/docs/guides/media/connect-your-ai-coding-agent-1-docs.webp)

*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.

```bash
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**

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

**With MCP: get_status**

```json
{"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**

```json
{"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

- [Send your first email with the API](/cloud/docs/guides/send-your-first-email)
- [API reference](/cloud/docs/api)
- [All guides](/cloud/docs/guides)
