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

Default (v1.0.4+): curated tools only — explicit schemas + annotations for Glama TDQS:

Tool	Purpose
vc_web_search	DuckDuckGo search → titles/URLs/snippets
vc_page_markdown	Fetch URL → markdown
vc_json_repair	Repair malformed LLM JSON
vc_agent_state_guard / vc_idempotency_guard / vc_drift_guard / vc_retry_storm_guard	Pre-flight reliability checks
pay	Proxy any catalog slug (or return 402 challenge)
health	Liveness

Set VIBES_MCP_FULL_CATALOG=1 to also register every live catalog slug (legacy; hurts TDQS min scores).

• Paid calls settle USDC via x402 (HTTP 402 → pay → retry), or use prepaid X-Vibes-Key / day-pass.
• Human fund UI: https://vibes-coded.com/start ($1 USDC → copy X-Vibes-Key).
• Mid-run rescue (Operator Interrupt): X-Operator-Notify → poll until status=funded.

Install

pip install mcp-server-vibes-coded
mcp-server-vibes-coded          # stdio MCP for local clients

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):

python mcp_server.py
# or: docker run -i --rm ghcr.io/doteyeso-ops/mcp-server-vibes-coded:1.0.5

HTTP mode (Smithery / inspectors):

PORT=3000 MCP_TRANSPORT=streamable-http python mcp_server.py
# health: GET /health  GET /healthz

Glama release steps: see GLAMA_RELEASE.md (Glama generates its own image; use stdio CMD, not HTTP). After push, use Sync Server on the Glama page so TDQS rescores.

Env:

• VIBES_ORIGIN — API base (default production Railway URL that bypasses Cloudflare)
• VIBES_MCP_FULL_CATALOG=1 — register all live catalog tools (off by default)
• 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):

1. Operator opens https://vibes-coded.com/start → pays $1 USDC → pastes X-Vibes-Key into the agent/MCP env
2. Or machine fund: POST /api/v1/outcomes/balance/fund
3. Mid-run without a key: X-Operator-Notify → human funds /start?ois= → poll for key

• Marketplace: https://vibes-coded.com
• Fund agent: https://vibes-coded.com/start
• Agent docs: https://vibes-coded.com/llms.txt
• Catalog: https://vibes-coded.com/api/v1/outcomes/meta
• Official connector (OpenClaw/Hermes): https://doteyeso-ops.github.io/vibes-coded-agent-connector/
• Glama: https://glama.ai/mcp/servers/@doteyeso-ops/mcp-server-vibes-coded
• Smithery: https://smithery.ai/servers/@doteyeso-ops/mcp-server-vibes-coded