# Discovery Oracle

Search and rank live network endpoints based on specific capabilities and connectivity. Monitor routing, payment telemetry, and trust metrics for various services and agents. Access a detailed catalo…

## Quick Start

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

# Browse available tools
npx -y @smithery/cli@latest tool list bot402/discovery-oracle

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bot402/discovery-oracle discover_endpoints

# Call a tool
npx -y @smithery/cli@latest tool call bot402/discovery-oracle discover_endpoints '{}'
```

## Direct MCP Connection

Endpoint: `https://discovery-oracle--bot402.run.tools`

## Tools (3)

- `discover_endpoints` — Search ranked live endpoint candidates by capability and network.
- `inspect_endpoint` — Inspect endpoint trust, routing, and payment telemetry.
- `inspect_agent` — Inspect agent routing and payment analytics.

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

## Resources

- `https://api.402.bot/mcp/resources/agent-metadata` — 402.bot well-known registration, card, and MCP endpoint metadata.
- `https://api.402.bot/mcp/resources/capability-catalog` — Discovery filters, supported tools, and current known capabilities.
- `https://api.402.bot/mcp/resources/paid-surfaces` — HTTP x402 route and transform surfaces exposed as MCP metadata.
- `https://api.402.bot/mcp/resources/top-capabilities` — Current highest-coverage live capabilities in the 402.bot catalog.
- `https://api.402.bot/mcp/resources/example-queries` — Copyable prompt and tool-call patterns for discovery and inspection.
- `https://api.402.bot/mcp/resources/setup-notes` — Client install snippets, auth notes, and prompt hints for 402.bot.