Wayforth Quickstart

Installation

Wayforth ships as an MCP (Model Context Protocol) server. Install it with uvx — no virtual environment needed:

uvx wayforth-mcp

Alternatively, install as a persistent package:

# Using uv
uv tool install wayforth-mcp

# Using pip
pip install wayforth-mcp

To add Wayforth to your AI assistant, configure it in your MCP client. For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "wayforth": {
      "command": "uvx",
      "args": ["wayforth-mcp"],
      "env": {
        "WAYFORTH_API_KEY": "wf_live_..."
      }
    }
  }
}

First search

Use wayforth_search to find services in natural language. Wayforth ranks results by WRI score — a reliability index based on uptime, latency, and payment success rate.

wayforth_search("translate to spanish")

Returns a ranked list of matching services:

[
  {
    "slug": "deepl",
    "name": "DeepL Translation",
    "description": "High-quality neural machine translation in 31 languages",
    "wri_score": 94,
    "tier": 2,
    "category": "translation",
    "payment_rails": ["card", "usdc", "x402"],
    "price_per_call": 0.003
  },
  {
    "slug": "google-translate",
    "name": "Google Cloud Translation",
    "wri_score": 91,
    "tier": 2,
    "category": "translation"
  }
]

Narrow results with filters:

wayforth_search("translate to spanish", max_price_usd=0.01, tier=2)

First execution

Once you have a slug, use wayforth_execute to run the service directly. Wayforth handles auth, billing, and failover automatically.

wayforth_execute(slug="deepl", text="Hello, world!", target_lang="ES")

Response:

{
  "translation": "¡Hola, mundo!",
  "detected_source_lang": "EN",
  "billed_calls": 1,
  "credits_remaining": 98
}

One-shot: search + execute

wayforth_run finds the best match for your query and executes it in one call — no slug needed:

wayforth_run("translate Hello to Spanish")

{
  "output": "Hola",
  "service": "deepl",
  "wri_score": 94
}

Authentication

All Wayforth APIs use a single API key passed as the x-wayforth-api-key header (or via the WAYFORTH_API_KEY environment variable for MCP).

export WAYFORTH_API_KEY="wf_live_your_key_here"

curl https://gateway.wayforth.io/v1/balance \
  -H "x-wayforth-api-key: $WAYFORTH_API_KEY"

{
  "credits_remaining": 100,
  "tier": "free",
  "usage": { "calls_this_period": 0 }
}

Free tier

Every account starts on the free tier — no credit card required.

Need more calls? Top-up packages can be added to any plan. See top-up packages.

Next steps