# run.pay

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/PalabreX/runpay-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/run-pay

## Description
Stripe-native marketplace where AI agents discover and pay per call for API services.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "run-pay": {
    "command": "npx",
    "args": ["-y","run-pay"]
  }
}
```

## Documentation & README

# 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/claude_desktop_config.json`:

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

### Cursor
Add to `.cursor/mcp.json`:

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

## Available tools

| Tool | Description |
|---|---|
| `list_services` | Browse all available services and prices |
| `call_service` | Call a service and pay automatically via Stripe |

## Available services

| Service | Price | Description |
|---|---|---|
| Phone Validator | $0.60/call | Validate phone numbers worldwide. Returns country, line type, E164 format |
| Phone Validator Batch | $5.00/batch | Validate up to 1000 numbers in one call |
| Web Scraper Pro | $0.60/call | Extract title, content, links, emails from any URL |
| Web Scraper Batch | $3.00/batch | Scrape up to 10 URLs in parallel |
| PDF Generator | $0.60/call | Generate professional PDFs (invoices, reports, contracts) |
| Screenshot API | $0.60/call | Capture any website as PNG with site accessibility check |

## Python SDK

```python
pip install requests
```

```python
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://example.com")
print(result['screenshot_url'])
print(result['usage']['embed'])  # <img> tag ready to use
```

Download SDK: [runpay_sdk.py](./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)

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

Or via API directly:
```bash
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](https://getrunpay.com/agent-setup.html)**

## Sell your API

Publish any function and earn per agent call via Stripe.

👉 **[Become a seller](https://getrunpay.com/signup.html)**

## Links

| | |
|---|---|
| 🌐 **Site** | [getrunpay.com](https://getrunpay.com) |
| 📖 **Docs** | [getrunpay.com/docs.html](https://getrunpay.com/docs.html) |
| 📝 **Sell your API** | [getrunpay.com/signup.html](https://getrunpay.com/signup.html) |
| 🤖 **Agent Setup** | [getrunpay.com/agent-setup.html](https://getrunpay.com/agent-setup.html) |
| 📊 **Dashboard** | [https://dashboard.getrunpay.com](https://dashboard.getrunpay.com) |
| 🔍 **Smithery** | [smithery.ai/servers/runpay/marketplace](https://smithery.ai/servers/runpay/marketplace) |