Skip to content

WayforthOfficial/wayforth

Wayforth — The API Runtime for AI Agents

One tool call. Any API. No setup.

Version License Tests


What It Is

Wayforth is the API runtime for AI agents — a single integration that gives any agent access to ~5,000 indexed APIs, ranked by real usage signals and executable with credits or crypto. Agents search, select, and pay for API services in one call without managing keys, credentials, or billing integrations. Built for developers who want their agents to reach the full surface area of the internet without building the infrastructure themselves.


Quick Start

Step 1 — Install the MCP server

uvx wayforth-mcp

Add to Claude Code permanently:

claude mcp add wayforth -- uvx wayforth-mcp

Step 2 — Get an API key

Sign up at wayforth.io/signup and copy your key from the dashboard.

Step 3 — Set your key

export WAYFORTH_API_KEY=wf_live_...

Step 4 — Run your first call

# Search — natural language, no keys needed
wayforth_search("translate text to Spanish")
# → DeepL   WRI: 82  Tier 2 ✓  managed
# → LibreTranslate  WRI: 71  Tier 2 ✓

# Execute — managed services, zero setup
wayforth_execute("deepl", {"text": "Hello", "target_lang": "ES"})
# → {"translations": [{"text": "Hola"}]}

Python SDK:

pip install wayforth-sdk
from wayforth import WayforthClient
client = WayforthClient(api_key="wf_live_...")
results = client.search("real-time stock data")

Full API reference: gateway.wayforth.io/guide/


Managed Services

16 live — managed services with zero API key setup. Wayforth holds the credentials — you call the tool.

Service Category Credits/call
Groq LLM inference 3
Together AI LLM inference 4
Mistral LLM inference 4
Gemini LLM inference 3
DeepL Translation 20
Serper Web search 3
Tavily Web search 10
Brave Web search 6
Perplexity (in queue) Web search 10
OpenWeather Weather data 2
NewsAPI News search 3
Alpha Vantage Financial data 4
Jina AI Content extraction 4
Firecrawl Web scraping 6
AssemblyAI Speech-to-text 25
Stability AI Image generation 86 (Core) · 150 (Ultra)
ElevenLabs (in queue) Text-to-speech 200
Resend Email 3

For Providers

Wayforth routes agent traffic to providers at scale.

  • Discovery — providers are indexed and ranked by WayforthRank, a scoring system driven by real agent payment signals. The more agents pay for a service, the higher it ranks.
  • x402-native — providers supporting the HTTP 402 micropayment protocol receive direct USDC settlement per call, non-custodial.
  • Managed — providers integrated as managed services receive monthly ACH payouts based on routed call volume.
  • Provider Dashboard — analytics portal showing calls, WRI scores, competitor data, estimated earnings, and agent identities. Intelligence and Premium tiers.

Provider plans:

Plan Monthly Annual (17% off)
Observer Free Free
Intelligence $99/mo $82/mo · $984/yr
Premium $299/mo $249/mo · $2,988/yr

Register your API: wayforth.io/providers


Catalog

Metric Count
APIs indexed ~5,000
Tier 2 verified 3,400+
x402-native services 277
Categories 19

WayforthRank scores every service 0–100 based on uptime history, probe frequency, payment conversion rate, and real agent usage patterns. Higher score = more trustworthy for agent workloads.

Coverage tiers:

  • Tier 0 — submitted, not yet probed
  • Tier 1 — probed, endpoint confirmed reachable
  • Tier 2 — automated reliability testing every 6 hours, score maintained
  • Tier 3 — managed integration, Wayforth holds the key

Payment Rails

Three ways to pay for API calls through Wayforth:

Rail Method Settlement
Card Stripe (fiat) Buy credits, spend as API calls
USDC Base blockchain Direct crypto deposits (+5% bonus credits)
x402 HTTP 402 protocol Per-call micropayments

x402 is the open HTTP-402 micropayment standard — agents pay per call with no subscription or balance required. Non-custodial escrow pays providers on confirmed execution.


MCP Tools

18 tools available via the Wayforth MCP server:

Tool Description
wayforth_search Search ~5,000 APIs by intent — returns ranked results with WRI scores
wayforth_query Structured discovery with WayforthQL — filter by tier, latency, region, price, payment rail
wayforth_run Intent-based routing with automatic reliability failover — returns result + failover status
wayforth_execute Direct execution of a managed service; auto-fails over to best alternative if degraded
wayforth_reliability Real-time reliability check — WRI score, tier, 7d uptime, last probe, failover candidate
wayforth_pay Pay for a service call via card credits or USDC on Base
wayforth_list List available services with category and tier filters
wayforth_status Live API health check and real-time service counts
wayforth_stats Catalog statistics — total services, tier breakdown
wayforth_keys Store your own API keys encrypted at rest (BYOK)
wayforth_remember Store a persistent memory entry for agent context
wayforth_recall Retrieve stored memories by query
wayforth_compare Side-by-side comparison of two services by slug
wayforth_similar Find services co-used alongside a given service
wayforth_identity Get or create your agent identity — trust score, reputation tier, usage history
wayforth_check_agent_identity Look up another agent's identity by wallet address
wayforth_set_wri_alert Set a webhook to fire when a service crosses a WRI score threshold
wayforth_quickstart Get started guide — returned as a formatted string

WayforthQL

Structured query language for precise API discovery. Filter by tier, latency, region, price, and payment rail.

POST https://gateway.wayforth.io/query
{
  "query": "fast inference for coding agents",
  "tier_min": 2,
  "sort_by": "wri",
  "latency_max": 500,
  "region": "us",
  "protocol": "x402",
  "price_max": 0.001,
  "limit": 5
}

Response fields:

Field Type Description
wayforth_id string Unique service ID: wayforth://<slug>
name string Service name
wri float WayforthRank score, 0–100
coverage_tier int Verification tier (0–3)
pricing_usdc float Price per request in USD
payment_protocol string One of: wayforth | x402 | any

protocol filter accepts: wayforth | x402 | any

x402 is the open HTTP-402 payment standard for per-call micropayments.

Full spec: gateway.wayforth.io/wayforthql-spec


Development Status

v0.8.13 — current release

  • Security hardening: SSRF validation on URL-fetching adapters, webhook DNS-rebind IP pinning, account-deletion grace hardening, DB-level email-canonical uniqueness, USDC tx_hash race fix, admin-gate rate limiting
  • /system/health auth-gated — unauthenticated callers receive {status, version} only
  • PostgreSQL password rotated; crawler switched to private network
  • 190+ tests passing, zero failures
  • 99.97% uptime
  • Health monitoring — all 16 managed services probed and tracked every 6h; never-succeeded services excluded from the /system/status degraded aggregate
  • Credits system — per-service credit costs enforced (Groq 3 cr, DeepL 20 cr, Stability AI 86 cr, etc.). Monthly quotas in credits: Free 100 · Builder 6,000 · Starter 21,000 · Pro 72,000 · Growth 240,000
  • Pioneer Program — indefinite enrollment, daily credit drip by tier, 7-day rejoin cooldown. Search responses include pioneer_routing, pioneer_routed_to_boosted, and signal_weight fields for opted-in developers
  • Provider annual billing — 17% discount for annual subscriptions (Intelligence $82/mo · Premium $249/mo)
  • LLM gatewayPOST /v1/chat/completions OpenAI-compatible endpoint with Groq → Together AI → Mistral failover and streaming
  • Tier 1 input caps — DeepL 2,000 chars, AssemblyAI ~10 min, Stability AI 1 image per call
  • API key encryption versioning — versioned Fernet keys, zero-downtime rotation
  • Provider email verification — required before service submission
  • Admin audit log — append-only, trigger-enforced
  • BYOK — bring your own API key for any indexed service (AES-256-GCM encrypted at rest)
  • MFA — TOTP-based authentication available

Plan quotas (credits/month):

Plan Credits/month Price
Free 100 Free
Builder 6,000 $12/mo
Starter 21,000 $29/mo
Pro 72,000 $99/mo
Growth 240,000 $299/mo
Enterprise 1,000,000 Custom

Pioneer Program: Opt in at POST /account/pioneer/join. Enrolled developers receive daily bonus credits (Growth: 1,200 cr/day) when they route searches through verified boosted services. Enrollment is indefinite — no 30-day cap. Opting out sets a 7-day rejoin cooldown. Field cooldown_days_remaining in the status response shows days remaining on the cooldown (null when enrolled).

Balance API response:

{
  "plan": "growth",
  "credits_remaining": 189375,
  "credits_included": 240000,
  "calls_remaining": 189375,
  "forecast": {
    "daily_avg_credits": 1919.44,
    "days_remaining_at_current_rate": 98
  }
}

calls_remaining is kept as a backward-compatible alias for credits_remaining.

Pricing: wayforth.io/pricing


Links


License

Business Source License 1.1 (BSL 1.1) — converts to Apache 2.0 on April 25, 2030.

© 2026 Wayforth Technologies Inc.