# Vibe Springs — Hosted MCP Server

**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.**

> This repository is the public manifest for the **hosted** Vibe Springs MCP server.
> The server runs at **`https://vibesprings.net/mcp`** — there is nothing to install
> or build. Connect directly over Streamable HTTP.

- 🌐 Endpoint: `https://vibesprings.net/mcp` (Streamable HTTP, stateless)
- 🧰 22 tools — 2 free, 20 pay-per-call
- 💸 Payment: x402 on Base mainnet (USDC), signed per call by the agent's own wallet
- 📖 Docs: <https://vibesprings.net/for-agents> · Catalog: <https://vibesprings.net/api/catalog>
- 🩺 Health: <https://vibesprings.net/api/health> · Status: <https://vibesprings.net/status>

---

## Connect

**Claude Code**
```bash
claude mcp add -t http vibesprings https://vibesprings.net/mcp
```

**Claude Desktop / Cursor** (config)
```json
{
  "mcpServers": {
    "vibesprings": {
      "type": "http",
      "url": "https://vibesprings.net/mcp"
    }
  }
}
```

No credentials are required to connect. Free tools work immediately; paid tools
return their payment requirements on the first call (see **Paying** below).

---

## Tools

### Free
| Tool | Description |
|---|---|
| `health` | Service health, upstream probes, facilitator reachability, 7-day reliability. |
| `search_services` | Search the full catalog of 52 x402 endpoints by keyword, category, or max price. |

### Weather & environment
| Tool | Price | Description |
|---|---|---|
| `get_forecast` | $0.002 | Up to 16-day weather forecast for any location. |
| `get_weather_history` | $0.002 | Historical daily weather worldwide. |
| `get_delay_risk` | $0.25 | Outdoor delay/disruption risk score (weather + soil trafficability), US. |
| `get_delay_risk_demo` | $0.002 | Demo of delay-risk on 5 fixed US locations. |

### Finance
| Tool | Price | Description |
|---|---|---|
| `get_exchange_rates` | $0.002 | Live & historical fiat FX rates (30+ currencies). |
| `convert_currency` | $0.002 | Convert any amount between 30+ fiat currencies. |
| `get_crypto_prices` | $0.005 | Live crypto prices, market caps, volume, changes. |
| `get_crypto_news` | $0.008 | Aggregated crypto news with sentiment and clustering. |
| `get_defi_yields` | $0.06 | Cross-protocol DeFi yield scanner (100+ protocols). |

### On-chain
| Tool | Price | Description |
|---|---|---|
| `get_gas_prices` | $0.001 | Gas oracle for Base, Ethereum, Arbitrum, Optimism. |
| `get_wallet_intel` | $0.10 | Wallet profiling: balances, tokens, activity, behavior tags. |
| `get_risk_report` | $0.10 | On-chain due-diligence report (6+ risk signals). |

### Composite (one call, many sources)
| Tool | Price | Description |
|---|---|---|
| `get_market_pulse` | $0.05 | Crypto + FX + gas + DeFi yields in a single call. |
| `get_travel_brief` | $0.05 | Forecast + air quality + holidays + FX for any city. |

### Standing loops (monitoring)
| Tool | Price | Description |
|---|---|---|
| `register_watch` | $0.01 | Register a price/gas/weather/wallet/endpoint watch condition. |
| `check_watch` | $0.008 | Check one watch condition against your baseline. |
| `check_watches_batch` | $0.02 | Check up to 5 watches in one call. |

### Merchant intelligence (for x402 sellers)
| Tool | Price | Description |
|---|---|---|
| `get_bazaar_category_trends` | $0.25 | Historical metrics & pricing momentum for a Bazaar tag. |
| `get_bazaar_competitors` | $0.50 | Closest competitor listings by tag/semantic overlap + your rank. |
| `audit_agent_visibility` | $0.75 | AEO/GEO auditor for any x402 endpoint's agent-discoverability. |

Live, always-accurate tool metadata: **<https://vibesprings.net/.well-known/mcp/server-card.json>**

---

## Paying (x402 over MCP)

Paid tools implement a two-step handshake so the agent stays in control of its wallet:

1. Call the tool **without** `payment_signature` → the response is a structured
   `payment_required` object with the exact x402 requirements (price, `payTo`, asset, nonce).
2. Sign the exact-scheme EIP-712 USDC authorization with your wallet
   (`@x402/fetch` for TS, `x402` for Python handle this), then call the tool
   **again** with the base64 token in the `payment_signature` argument.

Cheapest way to test the full flow end-to-end: `get_delay_risk_demo` ($0.002).

- Network: Base mainnet (`eip155:8453`)
- Asset: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)

---

## Links

- Website: <https://vibesprings.net>
- Agent onboarding: <https://vibesprings.net/for-agents>
- Machine catalog: <https://vibesprings.net/api/catalog>
- `llms.txt`: <https://vibesprings.net/llms.txt>
- `agents.txt`: <https://vibesprings.net/agents.txt>

Provider: Ilyistics LLC · Contact: support@vibesprings.net

## License

Documentation in this repository is released under the [MIT License](LICENSE).
The Vibe Springs service and its implementation are proprietary and not included here.