io.github.WayforthOfficial/wayforth

Manage BYOK (Bring Your Own Key) stored service keys. Store encrypted API keys for any service and call them via wayforth_execute with key_source='byok'. Keys are encrypted at rest with AES-128 and never returned in plaintext.

Get or create your agent identity on Wayforth. Returns your trust score, reputation tier, and usage history.

Look up an agent's identity and reputation on Wayforth. Returns tier (unknown/emerging/established/trusted/elite), trust score (0-100), call history, and cumulative spend. Agents build reputation automatically through x402 pay-per-call usage. No signup required. Tiers unlock higher rate limits: unknown: 10 calls/min emerging: 30 calls/min established: 60 calls/min trusted: 120 calls/min elite: unlimited

Register a webhook to be notified when any API service crosses a reliability score threshold. The webhook fires once per service per 24 hours when the score crosses upward through the threshold. Payload is HMAC-SHA256 signed with X-Wayforth-Signature for verification. Use this to automatically discover new high-quality services as they accumulate payment signals.

Get the Wayforth developer quickstart guide. Returns step-by-step instructions for using Wayforth in an agent.

Pay for a service through Wayforth. Two payment tracks: track='card' (default — no crypto needed): - Deducts from your Wayforth credit balance - Stripe Treasury processes the payment to the service - Get credits at wayforth.io/dashboard → Billing → Card Track track='crypto' (non-custodial — your wallet): - Returns Base calldata for you to broadcast - Your USDC, your wallet, fully on-chain - Non-custodial — Wayforth never holds your funds Routing fee: 1.5% on all tracks Args: service_id: Service to pay (from wayforth_search results) amount_usd: Amount to pay in USD (e.g. 0.001) track: Payment track — 'card' or 'crypto' (default: 'card') query_id: Optional query ID from wayforth_search for ranking signal

Search 300+ verified APIs ranked by merit-based ranking — real agent payment signals, not ads. Use this when you don't know which service to execute.

Browse the Wayforth service catalog.

Get current Wayforth catalog statistics.

Live reliability status for any service — current reliability score, Tier level, last probe result, and failover history. Use before long-running agent tasks to verify service health.

Intent-based routing with automatic reliability failover. Describe what you need — Wayforth selects the highest-reliability verified service and executes it. If the primary service degrades mid-session, automatically reroutes to the next verified equivalent. Returns result + failover status. Supports: translation, weather, news, stock prices, web search, image generation, speech-to-text, text-to-speech, email, and 300+ more catalog services. Optional: include agent_id='my-agent-name' to tag this call for per-agent analytics in your dashboard at wayforth.io/dashboard/agents.

Compare 2-5 API services side by side. Returns reliability scores, response times, costs, signal counts and a plain-English recommendation. Use this before committing to a service.

Find services similar to or commonly used alongside a given service. Returns co-usage patterns from real agent behavior.

Check real-time reliability for a service or category. Returns reliability score (0-100), Tier level, uptime over 7 days, last probe timestamp, and whether a verified failover alternative exists. Use to pre-check before committing to a service for a long-running task.

Save a service to agent memory for quick access later.

Recall services previously saved to memory.

Direct execution against a managed service by slug. If the service is below Tier 2 or reliability-degraded at call time, Wayforth fails over to the best verified alternative automatically. Returns result + failover status. Optional: include agent_id='my-agent-name' to tag this call for per-agent analytics in your dashboard at wayforth.io/dashboard/agents.

Structured service discovery using WayforthQL v2. More precise than wayforth_search — supports price caps, protocol filters, x402-only, provider filtering, and explicit sort order. Use when you need deterministic filtering rather than pure semantic ranking.