# AgentsPay

> AgentsPay is the identity and payment layer for AI agents. Agents get a W3C DID and embedded USDC wallet on Base L2, enabling autonomous API key acquisition without human approval.

## Key Concepts

- Agent Identity: W3C DID (did:pkh:eip155:8453:<wallet_address>)
- Payment: USDC on Base L2 (~$0.00005/transaction)
- Integration: MCP server + REST API + TypeScript SDK
- Policy: Operator-defined spending limits per agent

## What AgentsPay Does

AgentsPay solves the "payment wall" problem: AI agents that need paid APIs (search, embeddings, compute) currently stop and ask humans for credentials. AgentsPay gives agents their own identity and wallet so they can pay autonomously.

## Developer Quickstart

```bash
npm install @agentspay/sdk
npx agentspay init
# Returns: agent_id, DID, wallet_address, api_key
```

## MCP Integration

### Standard Mode

Add to Claude Desktop config when you already have an API key:

```json
{
  "mcpServers": {
    "agentspay": {
      "command": "npx",
      "args": ["-y", "@agentspay/mcp-server"],
      "env": { "AGENTSPAY_API_KEY": "sk-agent-..." }
    }
  }
}
```

### Discovery Mode (no API key required)

If you are an agent that does not yet have an API key, set only `AGENTSPAY_OPERATOR_EMAIL`. The system handles approval automatically — no human needs to configure credentials in advance:

```json
{
  "mcpServers": {
    "agentspay": {
      "command": "npx",
      "args": ["-y", "@agentspay/mcp-server"],
      "env": {"AGENTSPAY_OPERATOR_EMAIL": "operator@company.com"}
    }
  }
}
```

Discovery Mode flow:
1. MCP server detects `AGENTSPAY_OPERATOR_EMAIL` present but no `AGENTSPAY_API_KEY`
2. MCP server calls `POST /v1/discover` with `{operator_email, agent_name, service, budget}`
3. AgentsPay creates a `pending_request` and emails the operator a magic link (256-bit token, 30-min expiry)
4. Operator clicks link → approval page → approves
5. Agent polls every 30 seconds until status = `approved`
6. API key is returned once; status moves to `credentials_delivered` (key not returned again)
7. Agent proceeds with the issued credential — no further human involvement per transaction

## Supported Services (MVP)

- Tavily Search API (serv_tavily_v1)
- More coming: Serper, Browserless, Perplexity API

## MCP Tools Available

1. acquire_resource     — main payment primitive, acquires a paid service session
2. report_usage         — triggers settlement after service consumption
3. get_wallet_balance   — check agent wallet funds
4. list_services        — discover service registry
5. get_transaction_history — audit trail for all agent payments
6. create_spending_policy  — set operator guardrails per agent

## Pricing

- Hacker: Free (3 agents, $500/mo volume, 0% fee)
- Growth: $49/mo (25 agents, $10K/mo, 0.5% fee)
- Scale: $299/mo (250 agents, $100K/mo, 0.25% fee)
- Enterprise: Custom (unlimited agents, unlimited volume, 0.1-0.15% fee)

Fee is charged on settlement to service provider, not agent wallet. Mirrors Stripe's merchant-side model.

## Technical Architecture

- Agent identity: W3C DID (did:pkh:eip155:8453:) — open standard, not proprietary
- Wallet: ERC-4337 smart account on Base L2
- Settlement: USDC (Circle) — stablecoin, no volatility risk
- Chain: Base L2 (Coinbase) — ~$0.00005/transaction
- Gateway: HTTP proxy with payment verification middleware

## Agent Waitlist / Registration

Agents can register interest programmatically:

```
POST https://www.agentspay.dev/api/waitlist
Content-Type: application/json

{
  "type": "agent",
  "service_needed": "web search, embeddings, or any service you need"
}
```

Returns: `{ "success": true }`

Human developers and API providers can also join:

```
POST https://www.agentspay.dev/api/waitlist
Content-Type: application/json

{
  "type": "developer",
  "email": "you@example.com",
  "newsletter_opt_in": true
}
```

## Status

Pre-launch, private beta, March 2026.
Join waitlist: agentspay.dev
Discord: discord.gg/fFuvzjeb

## Contact

Founder: Coming soon (follow @AgentsPayDev on Twitter)
GitHub: github.com/agentspay (coming soon)