Metadata-Version: 2.4
Name: wayforth-mcp
Version: 0.2.5
Summary: MCP server for Wayforth — search engine and payment rail for AI agents
Project-URL: Homepage, https://wayforth.io
Project-URL: Repository, https://github.com/WayforthOfficial/wayforth
Project-URL: Documentation, https://api-production-fd71.up.railway.app/docs
License: MIT
Keywords: agents,ai,api,mcp,wayforth
Classifier: Development Status :: 3 - Alpha
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

MCP server for [Wayforth](https://github.com/your-org/wayforth) — discover AI services from Claude Code, Cursor, or any MCP-compatible client.

mcp-name: io.github.WayforthOfficial/wayforth

## Install (one command)

```bash
claude mcp add wayforth -- uv run --directory ~/Code/wayforth/packages/mcp-server python server.py
```

That's it. Claude Code will restart and the eight Wayforth tools will be available immediately.

## Tools

| Tool | Description |
|---|---|
| `wayforth_search` | Search services by natural language — returns WRI, tier label, price/req, and payment hint |
| `wayforth_list` | Browse catalog with optional category, tier, and limit filters |
| `wayforth_status` | Catalog stats (counts by tier and category) and API health |
| `wayforth_stats` | Detailed catalog statistics by tier and category |
| `wayforth_pay` | Pay for a service using Wayforth credits (1 credit = $0.001 USD) |
| `wayforth_remember` | Save a service to agent memory (persisted to API) |
| `wayforth_recall` | Recall services previously saved to memory, with optional filter |
| `wayforth_similar` | Find services co-used alongside a given service |

## Prerequisites

The Wayforth API must be running:

```bash
cd ~/Code/wayforth/apps/api
uv run uvicorn main:app --port 8000
```

By default the MCP server connects to `http://localhost:8000`. Override with:

```bash
export WAYFORTH_API_URL=https://api.wayforth.io
```

## Run manually (for testing)

```bash
cd ~/Code/wayforth/packages/mcp-server
uv run python server.py
```

The server starts on stdio and waits for MCP protocol messages. Press `Ctrl+C` to exit.

## Development

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