Vibe Springs
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
Open source Repository Open in the app JSON README (API)
About
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- net.vibesprings
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-07-28T16:16:46Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:01:50
- Updated
- 2026-08-29 04:01:50
- Origin id
net.vibesprings/x402-tools
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](LICENSE).
The Vibe Springs service and its implementation are proprietary and not included here.