
Wayforth
- 2 repo stars
- Updated June 30, 2026
- WayforthOfficial/wayforth
Wayforth is a MCP server that lets AI agents semantically search 2,300+ services and use an integrated payment rail to access them.
About
Wayforth is a Model Context Protocol server that acts as a search engine and payment rail for AI agents. developers shipping agents, automations, or SaaS backends can register it so Claude Code, Cursor, or Codex can semantically rank options from a catalog of over 2,300 services instead of guessing URLs or billing flows. It targets the build phase when you are wiring agent-tooling and third-party integrations: your agent queries capabilities, gets ranked matches, and can route through Wayforth’s payment layer rather than you manually onboarding every vendor. The server ships as a stdio PyPI package, which fits local agent workflows without standing up custom middleware. It is not a general web scraper or a single-domain API wrapper—it is catalog plus commerce for agent use. Expect intermediate setup (Python env, MCP config) and evolving 0.1.x APIs; pair it with your own auth and guardrails before production spend.
- Semantic search across 2,300+ agent-callable services
- Combined search and payment rail so agents can find and pay for APIs in one flow
- PyPI package (wayforth-mcp) with stdio transport for Claude Code and desktop MCP hosts
- Version 0.1.3 in the official MCP server schema
- GitHub-hosted WayforthOfficial/wayforth for updates and config
Wayforth by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
claude mcp add wayforth-mcp -- uvx wayforth-mcpAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 2 |
|---|---|
| Package | wayforth-mcp |
| Transport | STDIO |
| Auth | None |
| Last updated | June 30, 2026 |
| Repository | WayforthOfficial/wayforth ↗ |
What it does
Let your coding agent discover paid third-party APIs and services with semantic search instead of hard-coding every integration.
Who is it for?
Best when you're creating agents or automation products that must dynamically pick and pay for third-party APIs.
Skip if: Skip if you only need one fixed Stripe or OpenWeather integration with no service discovery.
What you get
After you add Wayforth to your agent, it can rank relevant external services and route payments instead of you hard-coding every vendor integration.
- MCP tools for semantic search over 2,300+ listed services
- Payment-rail flows callable from the agent for selected services
- Stdio MCP server entry ready for local agent sessions
By the numbers
- 2,300+ services in the searchable catalog
- Server schema version 0.1.3
- Transport: stdio via PyPI identifier wayforth-mcp
README.md
Wayforth — The API Runtime for AI Agents
One tool call. Any API. No setup.
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 | 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 |
|---|---|---|
| Observer | Free | Free |
| Intelligence | $99/mo | $85/mo · $1,020/yr (save $168) |
| Premium | $299/mo | $250/mo · $3,000/yr (save $588) |
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/healthauth-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/statusdegraded 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 · Starter 6,000 · Builder 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, andsignal_weightfields for opted-in developers - LLM gateway —
POST /v1/chat/completionsOpenAI-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 |
| Starter | 6,000 | $12/mo |
| Builder | 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
- Quickstart: wayforth.io/quickstart
- API Reference: gateway.wayforth.io/guide/
- Platform Overview: wayforth.io/Wayforth_Whitepaper_v6.10.pdf
- Dashboard: wayforth.io/dashboard
- For Providers: wayforth.io/providers
- PyPI (MCP): pypi.org/project/wayforth-mcp
- PyPI (SDK): pypi.org/project/wayforth-sdk
- Contact: wayforth.io/contact
License
Business Source License 1.1 (BSL 1.1) — converts to Apache 2.0 on April 25, 2030.
© 2026 Wayforth Technologies Inc.
Recommended MCP Servers
How it compares
MCP catalog and payment rail for agents, not a single REST skill or marketplace UI.
FAQ
Who is Wayforth for?
Developers building Claude Code, Cursor, or Codex agents that need to discover and pay for external APIs from a large service index.
When should I use Wayforth?
Use it during build when your agent must choose among many third-party services and you want semantic ranking plus payment routing instead of manual vendor research.
How do I add Wayforth to my agent?
Install the wayforth-mcp PyPI package, register the stdio MCP server in Claude Desktop or your agent’s MCP config, and point tools at your Wayforth credentials per the GitHub repo.