wayforth-mcp 0.1.8

MCP server for Wayforth — search engine and payment rail for AI agents

wayforth-mcp

MCP server for Wayforth — discover AI services from Claude Code, Cursor, or any MCP-compatible client.

mcp-name: io.github.WayforthOfficial/wayforth

Install (one command)

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	Generate payment calldata for USDC routing through Wayforth Escrow
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:

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

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

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

Run manually (for testing)

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

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