Galon Cloud
Galon API v1

Use Galon with your AI assistant

Connect the MCP server, or paste the starter prompt.

API key

Console › API keys › new test key with mail:send.

export GALON_API_KEY="gln_test_..."

Connect your AI

MCP server: https://api.galon.ai/v1/mcp · sign in with Galon (no key to copy), or the header Authorization: Bearer <key>

Chat assistants

Claude (claude.ai, Claude Desktop, mobile)

Sign in with Galon

  1. Open Customize, then Connectors, then “+ Add”, then “Add custom connector”.
  2. Name it Galon and paste the MCP server URL below.
  3. Leave the OAuth client on Claude's default, then select Add and Connect.
  4. Sign in to Galon, choose the project and its permissions, then select Allow.
  5. Team and Enterprise: an owner adds it once in Organization settings, Connectors, Add, Custom, Web; members then select Connect.

The Free plan allows one custom connector.

Sources: https://claude.com/docs/connectors/custom/add-unlisted.md, https://claude.com/docs/connectors/building/directory-vs-custom.md, https://claude.com/docs/connectors/building/authentication.md, https://support.claude.com/en/articles/11175166 (checked 2026-11-13)

ChatGPT

Sign in with Galon

  1. Open chatgpt.com/plugins, select “+”, then “Add custom MCP server”.
  2. Name it Galon, paste the MCP server URL below and choose OAuth.
  3. Select “Create as a plugin”, install it, then sign in to Galon and select Allow.
  4. Custom MCP servers depend on your ChatGPT plan and workspace settings.

ChatGPT does not accept API keys for MCP servers: it connects by sign-in only.

Sources: https://developers.openai.com/api/docs/guides/custom-mcp-server, https://developers.openai.com/apps-sdk/build/auth (checked 2026-11-13)

Mistral Le Chat

Sign in with Galon

  1. Open Connectors, select “+ Add Connector”, then the “Custom MCP Connector” tab.
  2. Name it galon (no spaces), paste the MCP server URL below and select Connect.
  3. Mistral Le Chat detects the sign-in method: sign in to Galon and select Allow. Only an administrator can add it.

Source: https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors (checked 2026-11-13)

Microsoft 365 Copilot (declarative agents)

Sign in with Galon

  1. In VS Code, open Agents Toolkit: Create a New Agent/App, Declarative Agent, Add an Action, then “Start with an MCP Server”.
  2. Paste the MCP server URL below, choose “OAuth (with dynamic registration)”, then Provision.
  3. Custom app upload and Copilot access must be enabled for your organisation.

Source: https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/build-mcp-plugins (checked 2026-11-13)

Coding agents and editors

Claude Code

Sign in with Galon

  1. Add the server, then run /mcp in Claude Code and choose Authenticate.
claude mcp add --transport http galon https://api.galon.ai/v1/mcp

With an API key

  1. Export your key, then add the project file below: Claude Code reads ${GALON_API_KEY} when it starts.

.mcp.json

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

Sources: https://code.claude.com/docs/en/mcp, https://code.claude.com/docs/en/plugins-reference (checked 2026-11-13)

OpenAI Codex (CLI, IDE extension)

Sign in with Galon

  1. Add the server, then sign in with codex mcp login galon.
codex mcp add galon --url https://api.galon.ai/v1/mcp
codex mcp login galon

With an API key

  1. Add this to ~/.codex/config.toml (or .codex/config.toml in a trusted project); Codex reads the key from GALON_API_KEY.

~/.codex/config.toml

[mcp_servers.galon]
url = "https://api.galon.ai/v1/mcp"
bearer_token_env_var = "GALON_API_KEY"

Sources: https://learn.chatgpt.com/docs/extend/mcp, https://learn.chatgpt.com/docs/config-file/config-reference (checked 2026-11-13)

Cursor

Sign in with Galon

  1. Select Add to Cursor, then sign in to Galon when Cursor asks.

With an API key

  1. Export your key before you open Cursor, then use this file (or the second button).

.cursor/mcp.json

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

Sources: https://cursor.com/docs/context/mcp, https://cursor.com/docs/context/mcp/install-links (checked 2026-11-13)

VS Code (GitHub Copilot)

Sign in with Galon

  1. Select Add to VS Code (or run the command), then sign in to Galon when VS Code asks.
code --add-mcp '{"name":"galon","type":"http","url":"https://api.galon.ai/v1/mcp"}'

With an API key

  1. Use this file: VS Code asks for the key once and keeps it in its secret storage.

.vscode/mcp.json

{
  "inputs": [
    { "type": "promptString", "id": "galon-key", "description": "Galon API key", "password": true }
  ],
  "servers": {
    "galon": {
      "type": "http",
      "url": "https://api.galon.ai/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:galon-key}" }
    }
  }
}

Sources: https://code.visualstudio.com/docs/agents/reference/mcp-configuration, https://code.visualstudio.com/api/extension-guides/ai/mcp (checked 2026-11-13)

Devin Desktop (formerly Windsurf)

Sign in with Galon

  1. Add the server, then sign in with devin mcp login.
devin mcp add galon --url https://api.galon.ai/v1/mcp
devin mcp login

With an API key

  1. Add this to .devin/mcp_config.json (project) or ~/.config/devin/mcp_config.json (user).

.devin/mcp_config.json

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

Sources: https://docs.devin.ai/desktop/cascade/mcp, https://docs.devin.ai/cli/extensibility/mcp/configuration.md (checked 2026-11-13)

Gemini CLI

Sign in with Galon

  1. Add the server, start Gemini CLI and run /mcp auth galon to sign in to Galon.
  2. Or install the Galon extension: gemini extensions install with the Galon extension repository, once it is published.
gemini mcp add --transport http galon https://api.galon.ai/v1/mcp

Sources: https://geminicli.com/docs/tools/mcp-server/, https://geminicli.com/docs/extensions/reference/ (checked 2026-11-13)

Antigravity CLI

Sign in with Galon

  1. Add this to ~/.gemini/config/mcp_config.json (or .agents/mcp_config.json in a workspace), then sign in to Galon when asked.

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "galon": { "serverUrl": "https://api.galon.ai/v1/mcp" }
  }
}

Source: https://antigravity.google/docs/mcp (checked 2026-11-13)

Visual Studio (GitHub Copilot)

Sign in with Galon

  1. Add this to %USERPROFILE%\.mcp.json (or .mcp.json in your solution), then select “Manage Authentication” above the server and sign in to Galon.

.mcp.json

{
  "servers": {
    "galon": { "url": "https://api.galon.ai/v1/mcp" }
  }
}

Source: https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers (checked 2026-11-13)

JetBrains Junie

Sign in with Galon

  1. Add this to ~/.junie/mcp/mcp.json (or .junie/mcp/mcp.json in a project).
  2. When the server shows “Authorization required”, select it, then Authorize, and sign in to Galon.

~/.junie/mcp/mcp.json

{
  "mcpServers": {
    "galon": { "url": "https://api.galon.ai/v1/mcp" }
  }
}

Source: https://junie.jetbrains.com/docs/junie-cli-mcp-configuration.html (checked 2026-11-13)

Amazon Q Developer (IDE and CLI)

Sign in with Galon

  1. IDE: in the chat, open the tools icon, select +, choose the http transport and paste the URL below; Amazon Q opens the Galon sign-in.
  2. CLI: add this server to your agent configuration, run /mcp and open the sign-in link.
{
  "mcpServers": {
    "galon": { "type": "http", "url": "https://api.galon.ai/v1/mcp" }
  }
}

Sources: https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/mcp-ide.html, https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-config-CLI.html (checked 2026-11-13)

OpenCode

Sign in with Galon

  1. Add this to opencode.jsonc, then sign in with opencode mcp auth galon.

opencode.jsonc

{
  "mcp": {
    "galon": { "type": "remote", "url": "https://api.galon.ai/v1/mcp" }
  }
}

With an API key

  1. Or turn sign-in off and read the key from GALON_API_KEY.

opencode.jsonc

{
  "mcp": {
    "galon": {
      "type": "remote",
      "url": "https://api.galon.ai/v1/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:GALON_API_KEY}" }
    }
  }
}

Source: https://opencode.ai/docs/mcp-servers/ (checked 2026-11-13)

Warp

Sign in with Galon

  1. Open Settings, Agents, MCP servers, select + Add, then “Streamable HTTP or SSE Server (URL)” and paste this.
  2. Select Start: Warp opens the Galon sign-in.
{
  "galon": { "url": "https://api.galon.ai/v1/mcp" }
}

Source: https://docs.warp.dev/knowledge-and-collaboration/mcp (checked 2026-11-13)

Zed

Sign in with Galon

  1. Add this to your Zed settings; Zed starts the sign-in when no Authorization header is set.

settings.json

{
  "context_servers": {
    "galon": { "url": "https://api.galon.ai/v1/mcp" }
  }
}

Source: https://zed.dev/docs/ai/mcp (checked 2026-11-13)

Kiro

Sign in with Galon

  1. Add the server without headers; Kiro signs in to Galon when it connects.

With an API key

  1. Add this to ~/.kiro/settings/mcp.json, then approve the GALON_API_KEY variable when Kiro asks.

~/.kiro/settings/mcp.json

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

Source: https://kiro.dev/docs/mcp/configuration/ (checked 2026-11-13)

GitHub Copilot coding agent

With an API key

  1. In the repository settings, open Copilot, then MCP servers, and paste this.
  2. Add the key as the environment secret COPILOT_MCP_GALON_API_KEY. This agent does not support sign-in for remote servers.
{
  "mcpServers": {
    "galon": {
      "type": "http",
      "url": "https://api.galon.ai/v1/mcp",
      "headers": { "Authorization": "Bearer $COPILOT_MCP_GALON_API_KEY" },
      "tools": ["*"]
    }
  }
}

Source: https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp (checked 2026-11-13)

App builders

Lovable

Sign in with Galon

  1. Open Connectors, select “Add custom”, then “MCP server”.
  2. Name it Galon, paste the MCP server URL below, keep OAuth and select “Add & authorize”.

With an API key

  1. Same form, but choose “Bearer token or API key”, paste a test key and select “Add server”.

Chat connections give Lovable context in the project chat; a published app calls the API itself.

Source: https://docs.lovable.dev/integrations/custom-mcp (checked 2026-11-13)

Bolt

Sign in with Galon

  1. Select the plus icon in the chat box, then Connectors, then “Manage connectors”.
  2. Select “Custom MCP server”, name it Galon, paste the MCP server URL below and keep the HTTP transport.
  3. Choose “MCP OAuth”, select Connect, then sign in to Galon.

Source: https://support.bolt.new/building/using-bolt/connect-mcp (checked 2026-11-13)

Replit Agent

Sign in with Galon

  1. Open Settings, Integrations, Your integrations, Add custom, then “Add personal MCP server”.
  2. Name it Galon, paste the MCP server URL below and select “Test & save”: sign in to Galon when asked.

Source: https://docs.replit.com/build/connect-via-mcp (checked 2026-11-13)

Other MCP clients

Goose

Sign in with Galon

  1. Select Add to Goose (or add a streamable HTTP extension with the URL below), then sign in to Galon.

Source: https://goose-docs.ai/docs/getting-started/using-extensions (checked 2026-11-13)

Raycast

Sign in with Galon

  1. Run the “Install MCP Server” command, choose HTTP and paste the MCP server URL below.
  2. Choose the Dynamic OAuth type, install, then sign in to Galon. MCP servers need Raycast Pro.

Source: https://manual.raycast.com/ai/model-context-protocol (checked 2026-11-13)

Notion Custom Agents

Sign in with Galon

  1. A workspace admin enables custom MCP servers: Settings, Connections, Manage.
  2. In the agent settings, open Tools & Access, Add connection, Custom MCP server, paste the URL below and select Connect. Business and Enterprise plans only.

Source: https://www.notion.com/help/mcp-connections-for-custom-agents (checked 2026-11-13)

Manus

With an API key

  1. Open Settings, Integrations, Custom MCP Servers, then Add Server.
  2. Name it Galon, paste the MCP server URL below and enter a test key as the Bearer token in the form (Manus stores it), then test the connection.

Source: https://manus.im/docs/integrations/custom-mcp (checked 2026-11-13)

Microsoft Copilot Studio

Sign in with Galon

  1. In your agent, open Tools, Add a tool, New tool, then Model Context Protocol.
  2. Paste the MCP server URL below and choose OAuth 2.0 with dynamic discovery.

Source: https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent (checked 2026-11-13)

Tools: get_status, send_email, list_emails, get_email, list_domains, add_domain, get_domain, verify_domain, list_suppressions, add_suppression, list_templates, create_template, get_template, publish_template. Each needs the scope of its API route.

Starter prompt

Paste it in Claude, ChatGPT, Mistral Le Chat, Microsoft 365 Copilot, Claude Code, OpenAI Codex, Cursor, VS Code, Devin Desktop, Gemini CLI, Antigravity CLI, Visual Studio, JetBrains Junie, Amazon Q Developer, OpenCode, Warp, Zed, Kiro, GitHub Copilot coding agent, Lovable, Bolt, Replit Agent, Goose, Raycast, Notion Custom Agents, Manus and Microsoft Copilot Studio. In an app builder, add GALON_API_KEY as a secret first.

Add email sending to this app with Galon.

1. Read https://cloud.galon.ai/llms-full.txt and follow it.
2. Server side only. Read the key from the GALON_API_KEY environment variable.
   Never hard-code it, log it or send it to the browser.
3. Send with POST https://api.galon.ai/v1/emails
   Headers: Authorization: Bearer $GALON_API_KEY, Content-Type: application/json,
   Idempotency-Key: a unique value per email, reused on retry.
   Body, for example: {"from": "Acme <hello@your-domain.com>", "to": ["ana@example.com"], "subject": "Welcome", "html": "<p>Welcome aboard</p>"}
4. Retry 429 and 5xx with backoff. On error, show detail.code and follow
   detail.next_action.hint when present.
5. Add one test that mocks the HTTP call. Never send real email from tests.

Examples

curl

curl https://api.galon.ai/v1/emails \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-0001" \
  -d '{"from": "Acme <hello@acme.com>", "to": ["ana@example.com"], "subject": "Welcome", "html": "<p>Welcome aboard</p>"}'

Node.js / TypeScript

export async function sendEmail(to: string[], subject: string, html: string, idempotencyKey: string) {
  const res = await fetch("https://api.galon.ai/v1/emails", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GALON_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": idempotencyKey, // same key on retry
    },
    body: JSON.stringify({ from: "Acme <hello@acme.com>", to, subject, html }),
  });
  const data = await res.json();
  if (!res.ok) throw new Error(data.detail?.code ?? `HTTP ${res.status}`);
  return data.email; // { id, ... }
}

Next.js — app/api/welcome/route.ts

export async function POST(req: Request) {
  const { email } = await req.json();
  const res = await fetch("https://api.galon.ai/v1/emails", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.GALON_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      from: "Acme <hello@acme.com>",
      to: [email],
      subject: "Welcome",
      html: "<p>Welcome aboard</p>",
    }),
  });
  return Response.json(await res.json(), { status: res.status });
}

Python

import json, os, urllib.request, uuid

req = urllib.request.Request(
    "https://api.galon.ai/v1/emails",
    data=json.dumps({"from": "Acme <hello@acme.com>", "to": ["ana@example.com"],
                     "subject": "Welcome", "html": "<p>Welcome aboard</p>"}).encode(),
    headers={"Authorization": "Bearer " + os.environ["GALON_API_KEY"],
             "Content-Type": "application/json",
             "Idempotency-Key": str(uuid.uuid4())},  # reuse it on retry
    method="POST",
)
with urllib.request.urlopen(req) as res:
    print(json.load(res)["email"]["id"])

PHP / Laravel

// config/services.php: 'galon' => ['key' => env('GALON_API_KEY')]
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;

$response = Http::withToken(config('services.galon.key'))
    ->withHeaders(['Idempotency-Key' => (string) Str::uuid()])
    ->post('https://api.galon.ai/v1/emails', [
        'from' => 'Acme <hello@acme.com>',
        'to' => ['ana@example.com'],
        'subject' => 'Welcome',
        'html' => '<p>Welcome aboard</p>',
    ])
    ->throw();

$emailId = $response->json('email.id');

llms-full.txt · OpenAPI