wallet_helper.mcp module

wallet-helper: Model Context Protocol (MCP) surface (optional [mcp] extra).

A thin adapter that exposes the FastAPI app from wallet_helper.api as MCP tools, so any MCP-aware host (an agent runtime, an IDE integration, a custom shell) can call the centralized dedup server — claim/run/submit a lease, check /stats, fetch a stored /result, /clear or /evict the store — as first-class tools. Uses fastapi-mcp (https://github.com/tadata-org/fastapi_mcp): one wrapper publishes the whole existing HTTP surface, so the routes are never duplicated.

Install the extra to pull in fastapi-mcp:

pip install "wallet-helper[mcp]"

Then run the server (HTTP API + MCP endpoint at /mcp):

wallet-helper-mcp             # console entry point
python -m wallet_helper.mcp   # equivalent

Author

Warith HARCHAOUI, https://linkedin.com/in/warith-harchaoui

wallet_helper.mcp.main()[source]

Console entry point (wallet-helper-mcp): serve the API + MCP endpoint.

Boots the FastAPI app (now serving both the plain HTTP routes and the /mcp MCP endpoint) with uvicorn in a single worker. Local-first: binds to loopback by default (override with WALLET_HELPER_HOST / WALLET_HELPER_PORT).

Return type:: None