Skip to main content

Quickstart — 2 minutes from zero to your first paid call

Register an agent, fund it, and run a paid service end-to-end. The fastest path is npx join-paygrid — no build, no clone, no config file.

1. Install (one line)​

npx join-paygrid

This drops a CLI + MCP server. The CLI walks you through registration interactively — it creates the agent, prints your agent_id and api_key, and writes a local config so subsequent commands just work.

2. Fund the agent​

After running the CLI, you'll get a deposit link. Open it in a browser and pay $5 via Stripe (card or iDEAL). Credits land on your agent's ledger in seconds.

Or, if you're crypto-native: send USDC directly to the agent's on-chain wallet (Base, Solana, or Tempo). The deposit watcher detects it within ~2 seconds and credits the ledger automatically.

npx join-paygrid deposit   # opens the deposit URL
npx join-paygrid balance   # confirm credits landed

3. Browse + run a service​

npx join-paygrid list
npx join-paygrid run fal-flux-dev '{"prompt":"a tiny cyberpunk cat"}'

The result lands in your terminal. Cost: whatever the service price is (Flux Dev is around $0.06 in USDC). Per-call billed — no subscription, no minimum.

4. Wire it into Claude / Cursor / Codex / Windsurf / Cline​

npx join-paygrid install claude   # or cursor, codex, windsurf, cline

That registers the MCP server with your editor. Now your AI agent can list and call any Paygrid service from chat — no copy-pasting curl, no API keys floating around.

Same flow, manually with curl​

If you'd rather not use the CLI (e.g. running from a script or another language), the raw HTTP flow is below. The backend is https://agents.cyber.jgsleepy.xyz.

Register​

curl -X POST https://agents.cyber.jgsleepy.xyz/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-first-agent",
    "description": "A test agent for the Paygrid platform"
  }'

Response:

{
  "success": true,
  "agent": {
    "id": "agent_abc123",
    "name": "my-first-agent",
    "api_key": "ak_live_xxxxxxxxxxxxxxxx"
  }
}

Save your api_key — you will need it for all authenticated requests.

Add credits​

Open the Stripe checkout URL in your browser to fund your agent:

https://agents.cyber.jgsleepy.xyz/api/payments/checkout?agent_id=agent_abc123&amount=500

Pay with card or iDEAL. After payment completes, 500 credits ($5.00) are added to your agent's balance.

Check your balance:

curl https://agents.cyber.jgsleepy.xyz/api/agents/agent_abc123/balance \
  -H "Authorization: Bearer ak_live_xxxxxxxxxxxxxxxx"

Browse services​

curl https://agents.cyber.jgsleepy.xyz/api/services

Execute a service​

curl -X POST https://agents.cyber.jgsleepy.xyz/api/services/execute \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak_live_xxxxxxxxxxxxxxxx" \
  -d '{
    "service_id": "svc_llm_gpt4",
    "input": {
      "prompt": "Explain quantum computing in one sentence."
    }
  }'

Response:

{
  "success": true,
  "result": {
    "output": "Quantum computing uses quantum mechanical phenomena like superposition and entanglement to process information in ways classical computers cannot.",
    "credits_charged": 10
  }
}

That's it — your agent just bought a service.

Next Steps​