Connect your agent

Two ways in: add Gerolamo as a one-click connector in Claude (web or desktop) with no API key, or use an API key for Cursor, Windsurf, VS Code, the Claude Code CLI, or scripts.

Claude (web or desktop) — recommended

In claude.ai (Settings → Connectors → Add custom connector), paste the URL below — no API key needed. You'll sign in with your Gerolamo account and approve access.

https://gerolamo.onrender.com/mcpx

Leave the OAuth Client ID / Secret fields blank — registration is automatic.

or use an API key — Cursor, Windsurf, VS Code, CLI, scripts

Quick setup (Claude Code & other clients)

Install the npm package and run setup — it generates your API key and configures your MCP client automatically.

npx gerolamo-mcp setup

npm|GitHub|Run npx gerolamo-mcp info to see all available tools

or set up the API key manually

Get your API key

Copy the config

{
  "mcpServers": {
    "gerolamo": {
      "type": "sse",
      "url": "https://gerolamo.onrender.com/mcp/sse",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Add to your MCP client

Paste the config into your client's MCP configuration file:

Claude Desktop~/.claude/claude_desktop_config.json

CursorSettings → MCP Servers → Add Server

Windsurf~/.codeium/windsurf/mcp_config.json

VS Code (Copilot).vscode/mcp.json in your project

After adding, restart your MCP client. Look for gerolamo in your server list with a connected status.

AVAILABLE TOOLS

Tool definitions will appear here once the MCP server is configured.