mcp-server-vibes-coded
MCP server that exposes Vibes-Coded pay-per-call x402 agent-tool endpoints as
discoverable MCP tools. Agents find this server on Glama / Smithery / the official
MCP Registry, then call tools that proxy to https://vibes-coded.com/api/v1/outcomes/{slug}.
What it does
- Auto-registers catalog endpoints as MCP tools (fetched live from Vibes-Coded discovery).
- Free-trial endpoints work with no auth. Paid endpoints settle USDC via x402 (HTTP 402 → pay → retry).
- Categories: agent reliability (state / idempotency / drift / retry-storm), memory, cost control,
supply-chain trust, and utilities (web-search, json-repair, page-markdown).
- Includes a
pay tool that returns the exact 402 challenge (or forwards PAYMENT-SIGNATURE).
- Prefer prepaid (
X-Vibes-Key) or a 24h day-pass (X-Day-Pass) over per-call wallet signing.
- Human fund UI: https://vibes-coded.com/start ($1 USDC → copy
X-Vibes-Key).
- Mid-run rescue (Operator Interrupt): send header
X-Operator-Notify: https://… on 402 → poll
GET /api/v1/operator-interrupt/{ois_…} until status=funded.
Install
pip install mcp-server-vibes-coded
mcp-server-vibes-coded
There is no npm package. Do not npx @doteyeso-ops/mcp-server-vibes-coded.
Hosted / Docker (Glama, Smithery)
Default (stdio — local clients, MCP Registry OCI, Glama mcp-proxy):
HTTP mode (Smithery / inspectors):
PORT=3000 MCP_TRANSPORT=streamable-http python mcp_server.py
Glama release steps: see GLAMA_RELEASE.md (Glama generates its own image; use stdio CMD, not HTTP).
Env:
VIBES_ORIGIN — API base (default production Railway URL that bypasses Cloudflare)
MCP_TRANSPORT=streamable-http + PORT — optional HTTP mode for hosted inspectors
HOST (HTTP mode only)
Payment
This server is a discovery + proxy wrapper. Payments settle on Vibes-Coded via OpenX402
(Solana USDC). Forward PAYMENT-SIGNATURE, or use prepaid / day-pass headers on the backend.
Preferred (no mid-run wallet):
- Operator opens https://vibes-coded.com/start → pays $1 USDC → pastes
X-Vibes-Key into the agent/MCP env
- Or machine fund:
POST /api/v1/outcomes/balance/fund
- Mid-run without a key:
X-Operator-Notify → human funds /start?ois= → poll for key