# Run Pay

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-palabrex-runpay-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PalabreX](https://agentstack.voostack.com/s/palabrex)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [PalabreX](https://github.com/PalabreX)
- **Source:** https://github.com/PalabreX/runpay-mcp

## Install

```sh
agentstack add mcp-palabrex-runpay-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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'])  #  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) |

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PalabreX](https://github.com/PalabreX)
- **Source:** [PalabreX/runpay-mcp](https://github.com/PalabreX/runpay-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-palabrex-runpay-mcp
- Seller: https://agentstack.voostack.com/s/palabrex
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.