MCP Server Setup

The Pods MCP Server is hosted and ready to use — no installation required. Point your AI host at the server URL and add your API key to start using all 25 tools and 9 prompts. Server URL: http://mcp.pods.finance/mcp

Prerequisites

A Pods API key — get one here
An MCP-compatible host: Claude Desktop or similar
Node.js installed (required for npx)

Claude Desktop

Open the configuration file

macOS
Windows

Open ~/Library/Application Support/Claude/claude_desktop_config.json

Open %APPDATA%\Claude\claude_desktop_config.json

Create the file if it does not exist.

Add the server entry

{
  "mcpServers": {
    "pods": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pods.finance/mcp",
        "--header",
        "x-api-key:your-api-key"
      ]
    }
  }
}

Claude Desktop uses mcp-remote as a bridge to connect to remote HTTP servers. The --allow-http flag is required because mcp-remote enforces HTTPS by default.

Restart Claude Desktop

Close and reopen the app. The Pods tools will appear in the tool picker.

Ask Claude “what Pods tools are available?” to confirm the connection.

Claude Code

Add the server

CLI
Config file

claude mcp add --transport http pods http://mcp.pods.finance/mcp --header "x-api-key:your-api-key"

Edit ~/.claude/mcp.json (global) or .claude/mcp.json (project):

{
  "mcpServers": {
    "pods": {
      "type": "http",
      "url": "http://mcp.pods.finance/mcp",
      "headers": { "x-api-key": "your-api-key" }
    }
  }
}

Claude Code supports HTTP transport natively — no mcp-remote required.

Verify the connection

claude mcp list

Ask Claude “what Pods tools are available?” to confirm the connection.

Cursor

Add the server

Config file
UI

Create or edit .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "pods": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://mcp.pods.finance/mcp",
        "--header",
        "x-api-key:your-api-key",
        "--allow-http"
      ]
    }
  }
}

Open Settings (Cmd+Shift+J) → Features → Model Context Protocol
Click Add new MCP server
Fill in Name pods, Command npx, and the args above
Toggle the server on

The --allow-http flag is required because mcp-remote enforces HTTPS by default.

Verify the connection

Open Cursor and ask in the chat “what Pods tools are available?” to confirm the connection.

The Pods tools will appear in the tool picker.

Google Gemini CLI

Add the server

CLI
Config file

gemini mcp add --transport http \
  --header "x-api-key:your-api-key" \
  pods http://mcp.pods.finance/mcp

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "pods": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://mcp.pods.finance/mcp",
        "--header",
        "x-api-key:your-api-key",
        "--allow-http"
      ]
    }
  }
}

Verify the connection

gemini mcp list

Or, inside a Gemini chat session, run /mcp enable pods.

Ask Gemini “what Pods tools are available?” to confirm the connection.

OpenAI Codex

Add the server

CLI
Config file

codex mcp add pods -- npx -y mcp-remote http://mcp.pods.finance/mcp --header x-api-key:your-api-key --allow-http

Edit ~/.codex/config.toml:

[mcp_servers.pods]
command = "npx"
args = ["-y", "mcp-remote", "http://mcp.pods.finance/mcp", "--header", "x-api-key:your-api-key", "--allow-http"]

Verify the connection

codex mcp list

Ask Codex “what Pods tools are available?” to confirm the connection.

Other Agents

Any MCP-compatible host that accepts a mcpServers JSON config can connect to the Pods server using mcp-remote:

{
  "mcpServers": {
    "pods": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://mcp.pods.finance/mcp",
        "--header",
        "x-api-key:your-api-key",
        "--allow-http"
      ]
    }
  }
}

Replace your-api-key with your Pods API key. The --allow-http flag is required because mcp-remote enforces HTTPS by default.

Prerequisites

Claude Desktop

Claude Code

Cursor

Google Gemini CLI

OpenAI Codex

Other Agents

Next Steps

Tools Reference

MCP Server Overview

​Prerequisites

​Claude Desktop

​Claude Code

​Cursor

​Google Gemini CLI

​OpenAI Codex

​Other Agents

​Next Steps

Tools Reference

MCP Server Overview

Prerequisites

Claude Desktop

Claude Code

Cursor

Google Gemini CLI

OpenAI Codex

Other Agents

Next Steps