# Vibe Springs [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/chrispy90/vibesprings-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vibe-springs

## Description
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.

## Tools
Capabilities this server exposes over MCP:

- **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.
- **get_forecast** — Up to 16-day weather forecast for any location.
- **get_weather_history** — Historical daily weather worldwide.
- **get_delay_risk** — Outdoor delay/disruption risk score (weather + soil trafficability), US.
- **get_delay_risk_demo** — Demo of delay-risk on 5 fixed US locations.
- **get_exchange_rates** — Live & historical fiat FX rates (30+ currencies).
- **convert_currency** — Convert any amount between 30+ fiat currencies.
- **get_crypto_prices** — Live crypto prices, market caps, volume, changes.
- **get_crypto_news** — Aggregated crypto news with sentiment and clustering.
- **get_defi_yields** — Cross-protocol DeFi yield scanner (100+ protocols).
- **get_gas_prices** — Gas oracle for Base, Ethereum, Arbitrum, Optimism.
- **get_wallet_intel** — Wallet profiling: balances, tokens, activity, behavior tags.
- **get_risk_report** — On-chain due-diligence report (6+ risk signals).
- **get_market_pulse** — Crypto + FX + gas + DeFi yields in a single call.
- **get_travel_brief** — Forecast + air quality + holidays + FX for any city.
- **register_watch** — Register a price/gas/weather/wallet/endpoint watch condition.
- **check_watch** — Check one watch condition against your baseline.
- **check_watches_batch** — Check up to 5 watches in one call.
- **get_bazaar_category_trends** — Historical metrics & pricing momentum for a Bazaar tag.
- **get_bazaar_competitors** — Closest competitor listings by tag/semantic overlap + your rank.
- **audit_agent_visibility** — AEO/GEO auditor for any x402 endpoint's agent-discoverability.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "vibe-springs": {
    "command": "npx",
    "args": ["-y","vibe-springs"]
  }
}
```

## Documentation & README

# 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](https://github.com/chrispy90/vibesprings-mcp/blob/HEAD/LICENSE).
The Vibe Springs service and its implementation are proprietary and not included here.