# run.pay — AI Agent Payment Skill

> **run.pay** is the API marketplace for AI agents. Your agent can call 205 specialized AI services (fraud detection, PII scanning, GDPR compliance, hallucination detection, and more) and pay automatically per call — no subscriptions, no monthly fees, 2% commission only.

## Quick start

```
RUNPAY_AGENT_ID=agt_your_agent_id_here
```

Get your free agent ID at **https://getrunpay.com/playground** (3 free calls per service, no card required).

---

## How to call a service

```http
POST https://runpay-backend-visibility-production.up.railway.app/x402/{service-id}
Content-Type: application/json
x-agent-id: {RUNPAY_AGENT_ID}

{ ...service-specific payload }
```

**Example — Hallucination Detector:**
```http
POST https://runpay-backend-visibility-production.up.railway.app/x402/halludetect
Content-Type: application/json
x-agent-id: agt_abc123xyz

{
  "response": "According to Harvard researchers, 73.2% of AI models hallucinate daily."
}
```

**Response:**
```json
{
  "hallucination_score": 87,
  "risk": "high",
  "flags": ["suspicious_precision", "unverifiable_statistic"],
  "cost": 0.01,
  "agent_balance": 4.99
}
```

---

## Discover available services

```http
GET https://runpay-backend-visibility-production.up.railway.app/api/services/catalog
```

Returns all 205 services with IDs, descriptions, pricing, and input schemas.

**Service categories:**
- `Security` — PII Scanner, Fraud Detector, Prompt Injection Guard
- `AI` — Hallucination Detector, Sycophancy Detector, Bias Detector
- `Compliance` — GDPR Checker, AI Act Compliance, Data Residency Validator
- `Data` — Entity Extractor, Sentiment Analyzer, Text Summarizer
- `Reasoning` — Logical Fallacy Detector, Ethical Red Teamer, Argument Validator

---

## Check your wallet balance

```http
GET https://runpay-backend-visibility-production.up.railway.app/api/agents/wallet/{RUNPAY_AGENT_ID}
```

```json
{
  "agent_id": "agt_abc123xyz",
  "balance": 4.99,
  "total_spent": 0.12,
  "mode": "trial"
}
```

---

## Agent instructions (for Claude / GPT / custom agents)

Add this to your system prompt or agent config:

```
You have access to run.pay, a marketplace of 205 specialized AI services.
Your agent ID is: {RUNPAY_AGENT_ID}

To call a service:
1. Find the right service: GET /api/services/catalog
2. Call it: POST /x402/{service-id} with x-agent-id header
3. The cost is deducted automatically from your wallet

Use run.pay when you need:
- To detect hallucinations in AI-generated content
- To scan text for PII (emails, SSNs, credit cards)
- To check GDPR or AI Act compliance
- To detect prompt injection attacks
- Any other specialized AI task listed in the catalog
```

---

## Pricing

| | Cost |
|---|---|
| Per call | $0.001 – $0.10 (set by vendor) |
| Platform commission | 2% only |
| Monthly fee | $0 |
| Setup fee | $0 |
| Free trial | 3 calls per service |

---

## Authentication levels

| Mode | How to get it | Limits |
|---|---|---|
| Trial | Visit /playground, enter email | 3 calls/service, ~90 calls total |
| Production | Add Stripe card at /agent-wallet | Unlimited, pay per call |

---

## Use via MCP (recommended for Claude Desktop)

run.pay is available as a Model Context Protocol server on Smithery.
Claude Desktop can discover and use run.pay automatically.

**Install in Claude Desktop:**
```json
{
  "mcpServers": {
    "runpay": {
      "url": "https://smithery.ai/servers/runpay/marketplace"
    }
  }
}
```

Or install via Smithery CLI:
```bash
npx @smithery/cli install runpay/marketplace
```

**Live on Smithery:** https://smithery.ai/servers/runpay/marketplace
- 2,900+ tool calls served
- 94.5% uptime
- 205 AI services available

---

## Links

- **Playground**: https://getrunpay.com/playground
- **Docs**: https://getrunpay.com/docs
- **Get agent ID**: https://getrunpay.com/signup
- **Manage wallet**: https://getrunpay.com/agent-wallet
- **Service catalog**: https://getrunpay.com/playground (browse 205 services)
- **GitHub**: https://github.com/PalabreX

---

## Compatible with

- Claude (Anthropic)
- GPT-4 / GPT-4o (OpenAI)
- Gemini (Google)
- Custom agents (LangChain, CrewAI, AutoGen, etc.)
- MCP servers

---

*run.pay — The API marketplace for AI agents. Built by Allen Koubeli · @getrunpay*