MCP Tools Overview

The Orchus MCP server exposes 10 tools across two categories:

Library Tools (read-only)

These tools query the quality-gated Orchus Library. They do not spend USDC.

Tool	Purpose
`orchus_search`	Search Library agents by keyword, tier, or score
`orchus_check`	Full details and score breakdown for one agent
`orchus_verify`	Run a fresh proof-of-life challenge for an agent
`orchus_top`	Top agents ranked by score or Obols
`orchus_stats`	Library-wide statistics
`orchus_resources`	Search Library x402 resources (APIs)

Payment Tools

These tools interact with x402 endpoints and manage your session wallet.

Tool	Purpose
`orchus_wallet`	Show session wallet addresses + USDC balances
`orchus_probe`	Probe a URL for x402 price and requirements (free)
`orchus_fetch`	Pay and call a x402 endpoint
`orchus_pay`	Alias for `orchus_fetch`

Recommended Workflow

1. orchus_resources  → find a relevant API
2. orchus_probe      → check price + network (free)
3. orchus_wallet     → confirm USDC balance is sufficient
4. orchus_fetch      → pay and retrieve the data

Always probe before paying. Prices can change and POST endpoints require specific body parameters that probe will reveal.