Skip to content

Gemini CLI AgentPay Resource/AgentPay usage guide

How to: Gemini CLI AgentPay AgentPay usage guide

client:Gemini CLI transport:streamable-http resource:AgentPay usage guide

Add AgentPay to Gemini CLI

  1. 01

    Open ~/.gemini/settings.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "agentpay": {
      "httpUrl": "https://agentpay-xhs-production.up.railway.app/mcp"
    }
  }
}
  1. 02

    Save the file and restart Gemini CLI.

  2. 03

    AgentPay usage guide is surfaced wherever your client lets you attach context. It is context to attach, not an action to run.

  3. 04

    If it does not appear, check that AgentPay is connected and that you are looking at its resources rather than its tools.

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

Set these first

AgentPay will not start until these are set, so it never reaches Gemini CLI.

  • AGENT_PRIVATE_KEY
  • MAX_SPEND_PER_CALL
  • GATEWAY_BASE_URL

Same resource, other clients

Read from the server itself, by connecting to it and calling resources/list on 24 September 2026. A listing does not declare its resources, so asking is the only way to know them, and this is what the server actually offers rather than what its listing claims. Names only are stored; connect the server for each resource's type and contents.