# {xpay} Documentation

> AI Agent Payment Control Platform - non-custodial spending controls and API monetization via the x402 protocol

Website: https://docs.xpay.sh
Platform: https://xpay.sh
Tools: https://xpay.tools

## xpay✦ Tools

1000+ pay-per-use MCP tools for AI agents. One API key, any MCP client.
- Overview: https://docs.xpay.sh/en/tools
- Get Started: https://docs.xpay.sh/en/tools/get-started
- Connect Your Client: https://docs.xpay.sh/en/tools/connect
- Browse & Search: https://docs.xpay.sh/en/tools/discover
- Master Server: https://docs.xpay.sh/en/tools/discover/master-server
- Publish Your Server: https://docs.xpay.sh/en/tools/publish
- API Reference: https://docs.xpay.sh/en/tools/reference
- Connection URLs: https://docs.xpay.sh/en/tools/reference/connection-urls
- Meta-Tools: https://docs.xpay.sh/en/tools/reference/meta-tools

### Client Setup Guides
- Cursor: https://docs.xpay.sh/en/tools/connect/cursor
- Claude Code: https://docs.xpay.sh/en/tools/connect/claude-code
- Claude Desktop: https://docs.xpay.sh/en/tools/connect/claude-desktop
- VS Code: https://docs.xpay.sh/en/tools/connect/vscode
- Windsurf: https://docs.xpay.sh/en/tools/connect/windsurf
- ChatGPT: https://docs.xpay.sh/en/tools/connect/chatgpt
- Gemini CLI: https://docs.xpay.sh/en/tools/connect/gemini-cli
- Cline: https://docs.xpay.sh/en/tools/connect/cline
- API / cURL: https://docs.xpay.sh/en/tools/connect/api-curl
- SDK: https://docs.xpay.sh/en/tools/connect/sdk

## Products

### Smart Proxy
Cost control proxy for autonomous AI agents. Set per-request, daily, and monthly spending limits. Sits between your agent and x402-powered APIs.
- Docs: https://docs.xpay.sh/en/products/smart-proxy

### Paywall-as-a-Service
Wrap any API with x402 payment requirements. Instant monetization with flexible pricing (per-request, tiered, token-based).
- Docs: https://docs.xpay.sh/en/products/paywall-service

### MCP Monetization
Monetize any MCP (Model Context Protocol) server with pay-per-tool-call billing. Zero code changes required.
- Docs: https://docs.xpay.sh/en/products/mcp-monetization

## x402 Protocol

Open payment protocol using HTTP 402 status code for instant stablecoin micropayments.
- Overview: https://docs.xpay.sh/en/x402-protocol
- xpay Facilitator: https://docs.xpay.sh/en/x402-protocol/facilitator

### xpay Facilitator
Free x402 facilitator service for USDC payment verification and settlement on Base.
- URL: https://facilitator.xpay.sh
- Networks: Base mainnet (eip155:8453), Base Sepolia (eip155:84532)
- Protocol versions: v1, v2
- Endpoints: /health, /supported, /verify, /settle

## Developer Resources

- Getting Started: https://docs.xpay.sh/en/getting-started
- Installation: https://docs.xpay.sh/en/getting-started/installation
- SDK Reference: https://docs.xpay.sh/en/developer-resources/sdk-reference
- Integration Patterns: https://docs.xpay.sh/en/developer-resources/integration-patterns
- Troubleshooting: https://docs.xpay.sh/en/developer-resources/troubleshooting

## Integrations

- n8n: https://docs.xpay.sh/en/integrations/n8n
- n8n Cloud: https://docs.xpay.sh/en/integrations/n8n-cloud
- Activepieces: https://docs.xpay.sh/en/integrations/activepieces
- Universal Webhook: https://docs.xpay.sh/en/integrations/universal-webhook

## Key Technical Details

- Blockchain: Base (Coinbase L2), USDC stablecoin
- Architecture: Non-custodial (funds never held by xpay)
- Settlement: ~2 seconds on Base
- SDK: @xpaysh/agent-kit (TypeScript)
- Auth: API keys (tools platform), Privy (legacy hub)

## Links

- Documentation: https://docs.xpay.sh
- Platform: https://xpay.sh
- Tools: https://xpay.tools
- GitHub: https://github.com/xpaysh
- Discord: https://discord.gg/vukXDGT7n5
- Full docs bundle: https://docs.xpay.sh/llms-full.txt
- OpenAPI spec: https://docs.xpay.sh/openapi.json