join-paygrid

CLI + MCP server for Paygrid (paygrid.space) — let your agent pay for services in USDC.

npx join-paygrid

That's it. Registers a fresh agent, saves the api_key locally, opens your wallet to fund it, and offers to install Paygrid as an MCP server in Claude Code, Cursor, Codex, Windsurf, or Cline.

What is Paygrid?

A marketplace where AI agents pay for services per call in USDC: web scraping, image generation, on-chain data, crypto sentiment, and more. Your agent gets one api_key, one balance, and N services across multiple chains.

Install

npx join-paygrid             # interactive onboard

Or globally:

npm install -g join-paygrid
join-paygrid

Commands

| Command | Description | |---------|-------------| | join-paygrid | Register agent, fund wallet, install MCP | | join-paygrid mcp | Run as MCP server (stdio transport) | | join-paygrid balance | Show current credit balance | | join-paygrid deposit | Open the wallet to fund | | join-paygrid list | List available services with prices | | join-paygrid run <slug> '<json>' | Call a service from CLI | | join-paygrid install <agent> | Install MCP for: claude / cursor / codex / windsurf / cline | | join-paygrid logout | Clear local config |

MCP tools

When installed via join-paygrid install <agent>, the following MCP tools become available to your coding agent:

• aaas_balance — check balance
• aaas_deposit_url — mint a Stripe checkout URL for the human
• aaas_access_link — mint a JWT-signed wallet URL
• aaas_list_services — list services with prices
• aaas_call — generic: call any service by slug
• aaas_scrape — web scrape via Firecrawl ($0.01)
• aaas_search — web search via Firecrawl ($0.015)
• aaas_image_gen — image generation via Fal ($0.06–$0.10)
• aaas_crypto_price — live crypto prices via Solana x402 ($0.002)
• aaas_reddit_sentiment — Reddit sentiment via Base x402 ($0.04)

Note: tool names are kept stable (aaas_*) so existing MCP clients keep working across the rename.

Manual install (no CLI prompts)

~/.claude/mcp.json (Claude Code), ~/.cursor/mcp.json (Cursor), or equivalent:

{
  "mcpServers": {
    "paygrid": {
      "command": "npx",
      "args": ["-y", "join-paygrid", "mcp"],
      "env": {
        "AAAS_API_KEY": "ct_your_api_key_here",
        "AAAS_AGENT_ID": "your-agent-uuid"
      }
    }
  }
}

Environment variables

| Variable | Default | Purpose | |----------|---------|---------| | AAAS_API_KEY | from ~/.aaas/config.json | Override the saved agent api_key | | AAAS_AGENT_ID | from ~/.aaas/config.json | Override the saved agent id | | AAAS_API_URL | https://agents.cyber.jgsleepy.xyz | API endpoint (override for self-hosted) | | AAAS_FRONTEND_URL | https://paygrid.space | Wallet UI URL |

Links

• Marketplace: https://paygrid.space
• Wallet: https://paygrid.space/wallet
• Become a service seller: [email protected]

License

MIT