Built for AI agents

Every PAYGSEO tool, callable by your agent

Point Claude, Cursor, ChatGPT or any custom agent at one docs page and it can run the entire PAYGSEO suite — keyword research, Google results snapshots, rank checks, content outlines — paying per credit, with the remaining balance returned on every call.

One-line setup

Drop this into any agent chat:

Create a new skill for PAYGSEO using https://paygseo.com/docs

This points to our public docs page which describes every tool, its inputs, pricing, and how to read remaining credits — so the agent can use PAYGSEO autonomously.

Connect via MCP

Add this to your Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "paygseo": {
      "url": "https://paygseo.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer pgs_live_xxxxxxxx"
      }
    }
  }
}

JSON-RPC 2.0 over HTTP. Supports initialize, tools/list, and tools/call.

Or call the REST API directly

Base URL: https://paygseo.com/functions/v1/api-v1

# List tools
curl https://paygseo.com/functions/v1/api-v1/tools \
  -H "Authorization: Bearer $PAYGSEO_KEY"

# Check credits
curl https://paygseo.com/functions/v1/api-v1/credits \
  -H "Authorization: Bearer $PAYGSEO_KEY"

# Run a tool
curl https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/run \
  -H "Authorization: Bearer $PAYGSEO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"best running shoes","market":"us-en"}'

# Recent history for a tool (free, rate-limited, caller-scoped)
curl "https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/history?limit=10" \
  -H "Authorization: Bearer $PAYGSEO_KEY"

# Fetch a full past result
curl https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/results/RUN_UUID \
  -H "Authorization: Bearer $PAYGSEO_KEY"

# Recent runs across all tools
curl "https://paygseo.com/functions/v1/api-v1/history?limit=20" \
  -H "Authorization: Bearer $PAYGSEO_KEY"

History and result endpoints are strictly scoped to the API key's owning account. A run_id that belongs to another user returns 404 Not Found — existence is never leaked across accounts. MCP mirrors this via {slug}__history, {slug}__result, and list_history.

Every response

Includes credits_used, credits_remaining, and the X-Credits-Remaining header so your agent always knows the budget.

Rate limited & safe

60 req/min and 1,000 req/hour per key. Standard X-RateLimit-* headers and a Retry-After on 429.

Full tool reference lives in the docs

Every tool's inputs, outputs, pricing, and copy-ready REST + MCP snippets are on the docs page.

NewInteractive in-chat results (MCP Apps)

Hosts that support the MCP Apps extension (Claude, VS Code Copilot, Goose, MCPJam…) render every PAYGSEO tool result as a sortable table, KPI card, or outline view directly in the chat — no JSON walls.

Works automatically for every tool. Non-supporting hosts fall back to the standard JSON response.

Ready to wire up your agent?

Create your first API key and start running SEO tools from any agent.