Metadata-Version: 2.4
Name: wayforth-mcp
Version: 0.8.3
Summary: MCP server for Wayforth — The API Runtime for AI Agents.
Project-URL: Homepage, https://wayforth.io
Project-URL: Repository, https://github.com/WayforthOfficial/wayforth
Project-URL: Documentation, https://gateway.wayforth.io/docs
Author: Wayforth Technologies Inc.
License: MIT
Keywords: agents,ai,api,mcp,wayforth
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.0.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: uvicorn>=0.30
Description-Content-Type: text/markdown

# wayforth-mcp

[![PyPI](https://img.shields.io/pypi/v/wayforth-mcp)](https://pypi.org/project/wayforth-mcp/)

MCP server for [Wayforth](https://wayforth.io) — one tool call to search, execute, and pay for any of 4,974 indexed APIs.

mcp-name: io.github.WayforthOfficial/wayforth

## Install

```bash
uvx wayforth-mcp
```

Add to Claude Code permanently:

```bash
claude mcp add wayforth -- uvx wayforth-mcp
```

## Setup

Get an API key at [wayforth.io/signup](https://wayforth.io/signup), then set it in your environment:

```bash
export WAYFORTH_API_KEY=wf_live_...
```

## Tools

| Tool | Description |
|------|-------------|
| `wayforth_search` | Search 4,974 APIs by natural language — returns WRI scores, tier, price/req |
| `wayforth_query` | Structured discovery — filter by tier, latency, region, price, payment rail |
| `wayforth_run` | Intent-based routing: describe what you need, Wayforth picks and executes |
| `wayforth_execute` | Direct execution of a managed service by slug — no API key required |
| `wayforth_pay` | Pay for a service via card credits or USDC on Base |
| `wayforth_list` | Browse catalog with category, tier, and limit filters |
| `wayforth_status` | Live API health and service counts |
| `wayforth_keys` | Store your own API keys encrypted at rest (BYOK) |
| `wayforth_remember` | Save a service to persistent agent memory |
| `wayforth_recall` | Retrieve services previously saved to memory |
| `wayforth_compare` | Side-by-side comparison of two services by slug |
| `wayforth_similar` | Find services co-used alongside a given service |
| `wayforth_quickstart` | Get started guide — returned as a formatted string |

## Development

```bash
cd packages/mcp-server
uv sync
uv run python server.py
```
