run.pay MCP server

run.pay — Agent Marketplace

Stripe-native marketplace where AI agents autonomously discover and purchase API services. Pay-per-call, no accounts needed.

MCP Endpoint

https://runpay-backend-visibility-production.up.railway.app/mcp

Connect your agent

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "runpay": {
      "url": "https://runpay-backend-visibility-production.up.railway.app/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "runpay": {
      "url": "https://runpay-backend-visibility-production.up.railway.app/mcp",
      "transport": "http"
    }
  }
}

Available tools

Available services

Python SDK

pip install requests

from runpay_sdk import RunPay

# Initialize (sandbox=True for testing without payment)
rp = RunPay(agent_id="my-agent-001", sandbox=False)

# Validate a phone number — $0.60
result = rp.validate_phone("+33612345678")
print(result['country'])     # France
print(result['line_type'])   # mobile
print(result['is_valid'])    # True

# Validate 1000 numbers in one call — $5.00
result = rp.validate_phones_batch(["+33612345678", "+1234567890"])
print(f"{result['valid']}/{result['total']} valid")

# Scrape a website — $0.60
result = rp.scrape("https://example.com")
print(result['title'])
print(result['emails'])

# Scrape 10 URLs in parallel — $3.00
result = rp.scrape_batch(["https://site1.com", "https://site2.com"])

# Generate an invoice PDF — $0.60
result = rp.generate_pdf(
    title="Invoice #001",
    doc_type="invoice",
    language="fr",
    data={
        "client": "Acme Corp\n123 Rue de Paris",
        "invoice_number": "INV-001",
        "tax_rate": 20,
        "items": [
            {"description": "Web Scraping", "qty": 10, "price": 0.60}
        ]
    }
)
with open("invoice.html", "w") as f:
    f.write(result['html'])

# Take a screenshot — $0.60
result = rp.screenshot("https:/

Download SDK: runpay_sdk.py

How it works

1. Sellers publish any API function and set a price per call
2. AI agents discover services via MCP protocol automatically
3. Stripe charges the agent per call automatically
4. Sellers receive payouts directly via Stripe Connect

Sandbox mode (test without payment)

# No real payment — perfect for development
rp = RunPay(agent_id="my-agent-001", sandbox=True)
result = rp.validate_phone("+33612345678")

Or via API directly:

curl -X POST https://runpay-backend-visibility-production.up.railway.app/api/sandbox/call/SERVICE_ID \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-agent","payload":{"phone":"+33612345678"}}'

Setup your agent wallet

Before calling paid services, your agent needs a payment card attached.

👉 Setup Agent Wallet

Sell your API

Publish any function and earn per agent call via Stripe.

👉 Become a seller

Links

Shortened. The full README is on GitHub.