# x402 Service Discovery

Discovers x402-payable APIs at runtime. Enables autonomous agents to find, evaluate, and pay for services via USDC micropayments on Base — no API keys or subscriptions required.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add rplryan/x402-discovery

# Browse available tools
npx -y @smithery/cli@latest tool list rplryan/x402-discovery

# Get full schema for a tool
npx -y @smithery/cli@latest tool get rplryan/x402-discovery x402_discover

# Call a tool
npx -y @smithery/cli@latest tool call rplryan/x402-discovery x402_discover '{}'
```

## Direct MCP Connection

Endpoint: `https://rplryan.run.tools`

**Optional config:**
- `baseUrl` (query) — Override the discovery API base URL (optional, default: https://x402-discovery-api.onrender.com)
- `maxResults` (query) — Maximum results to return per query (optional, default: 10)
- `minUptimePct` (query) — Filter out services below this uptime threshold (optional, default: 0)

## Tools (5)

- `x402_discover` — Discover x402-payable services matching a query. Returns matching endpoints with quality signals (uptime, latency, paym…
- `x402_browse` — Browse all registered x402-payable services with optional filtering by category. Returns the full catalog for free — no…
- `x402_health` — Check the health and uptime statistics of a specific x402 service by URL. Free — no payment required.
- `x402_trust` — Get the ERC-8004 on-chain trust profile for a service or wallet. Returns identity verification, reputation score, and t…
- `x402_register` — Register a new x402-payable service in the discovery catalog. Free to register — no payment required.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get rplryan/x402-discovery <tool-name>
```

## Resources

- `x402://catalog` — Full registry of x402-payable services with quality signals
- `x402://docs` — Documentation for the x402 HTTP payment standard

## Prompts (2)

- `find_service_for_task` (task) — Find the best x402 service for a specific task
- `discover_and_verify` (capability) — Discover and verify an x402 service by capability, then check health before use