{
  "markdown": "# Vibe Springs — Hosted MCP Server\n\n**Pay-per-use data & intelligence tools for AI agents. No API keys, no accounts — paid tools settle per call in USDC on Base via the [x402](https://www.x402.org) protocol.**\n\n> This repository is the public manifest for the **hosted** Vibe Springs MCP server.\n> The server runs at **`https://vibesprings.net/mcp`** — there is nothing to install\n> or build. Connect directly over Streamable HTTP.\n\n- 🌐 Endpoint: `https://vibesprings.net/mcp` (Streamable HTTP, stateless)\n- 🧰 22 tools — 2 free, 20 pay-per-call\n- 💸 Payment: x402 on Base mainnet (USDC), signed per call by the agent's own wallet\n- 📖 Docs: <https://vibesprings.net/for-agents> · Catalog: <https://vibesprings.net/api/catalog>\n- 🩺 Health: <https://vibesprings.net/api/health> · Status: <https://vibesprings.net/status>\n\n---\n\n## Connect\n\n**Claude Code**\n```bash\nclaude mcp add -t http vibesprings https://vibesprings.net/mcp\n```\n\n**Claude Desktop / Cursor** (config)\n```json\n{\n  \"mcpServers\": {\n    \"vibesprings\": {\n      \"type\": \"http\",\n      \"url\": \"https://vibesprings.net/mcp\"\n    }\n  }\n}\n```\n\nNo credentials are required to connect. Free tools work immediately; paid tools\nreturn their payment requirements on the first call (see **Paying** below).\n\n---\n\n## Tools\n\n### Free\n| Tool | Description |\n|---|---|\n| `health` | Service health, upstream probes, facilitator reachability, 7-day reliability. |\n| `search_services` | Search the full catalog of 52 x402 endpoints by keyword, category, or max price. |\n\n### Weather & environment\n| Tool | Price | Description |\n|---|---|---|\n| `get_forecast` | $0.002 | Up to 16-day weather forecast for any location. |\n| `get_weather_history` | $0.002 | Historical daily weather worldwide. |\n| `get_delay_risk` | $0.25 | Outdoor delay/disruption risk score (weather + soil trafficability), US. |\n| `get_delay_risk_demo` | $0.002 | Demo of delay-risk on 5 fixed US locations. |\n\n### Finance\n| Tool | Price | Description |\n|---|---|---|\n| `get_exchange_rates` | $0.002 | Live & historical fiat FX rates (30+ currencies). |\n| `convert_currency` | $0.002 | Convert any amount between 30+ fiat currencies. |\n| `get_crypto_prices` | $0.005 | Live crypto prices, market caps, volume, changes. |\n| `get_crypto_news` | $0.008 | Aggregated crypto news with sentiment and clustering. |\n| `get_defi_yields` | $0.06 | Cross-protocol DeFi yield scanner (100+ protocols). |\n\n### On-chain\n| Tool | Price | Description |\n|---|---|---|\n| `get_gas_prices` | $0.001 | Gas oracle for Base, Ethereum, Arbitrum, Optimism. |\n| `get_wallet_intel` | $0.10 | Wallet profiling: balances, tokens, activity, behavior tags. |\n| `get_risk_report` | $0.10 | On-chain due-diligence report (6+ risk signals). |\n\n### Composite (one call, many sources)\n| Tool | Price | Description |\n|---|---|---|\n| `get_market_pulse` | $0.05 | Crypto + FX + gas + DeFi yields in a single call. |\n| `get_travel_brief` | $0.05 | Forecast + air quality + holidays + FX for any city. |\n\n### Standing loops (monitoring)\n| Tool | Price | Description |\n|---|---|---|\n| `register_watch` | $0.01 | Register a price/gas/weather/wallet/endpoint watch condition. |\n| `check_watch` | $0.008 | Check one watch condition against your baseline. |\n| `check_watches_batch` | $0.02 | Check up to 5 watches in one call. |\n\n### Merchant intelligence (for x402 sellers)\n| Tool | Price | Description |\n|---|---|---|\n| `get_bazaar_category_trends` | $0.25 | Historical metrics & pricing momentum for a Bazaar tag. |\n| `get_bazaar_competitors` | $0.50 | Closest competitor listings by tag/semantic overlap + your rank. |\n| `audit_agent_visibility` | $0.75 | AEO/GEO auditor for any x402 endpoint's agent-discoverability. |\n\nLive, always-accurate tool metadata: **<https://vibesprings.net/.well-known/mcp/server-card.json>**\n\n---\n\n## Paying (x402 over MCP)\n\nPaid tools implement a two-step handshake so the agent stays in control of its wallet:\n\n1. Call the tool **without** `payment_signature` → the response is a structured\n   `payment_required` object with the exact x402 requirements (price, `payTo`, asset, nonce).\n2. Sign the exact-scheme EIP-712 USDC authorization with your wallet\n   (`@x402/fetch` for TS, `x402` for Python handle this), then call the tool\n   **again** with the base64 token in the `payment_signature` argument.\n\nCheapest way to test the full flow end-to-end: `get_delay_risk_demo` ($0.002).\n\n- Network: Base mainnet (`eip155:8453`)\n- Asset: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)\n\n---\n\n## Links\n\n- Website: <https://vibesprings.net>\n- Agent onboarding: <https://vibesprings.net/for-agents>\n- Machine catalog: <https://vibesprings.net/api/catalog>\n- `llms.txt`: <https://vibesprings.net/llms.txt>\n- `agents.txt`: <https://vibesprings.net/agents.txt>\n\nProvider: Ilyistics LLC · Contact: support@vibesprings.net\n\n## License\n\nDocumentation in this repository is released under the [MIT License](LICENSE).\nThe Vibe Springs service and its implementation are proprietary and not included here.\n",
  "bytes": 4993,
  "sha": "06e127110d24360da8b95ec9629023f33d31b508151b153871c540f24b7968fa",
  "repo_slug": "chrispy90/vibesprings-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_net_vibesprings_x402_tools_0dd52143/readme"
}