Optimized for Autonomous AI Agents

For Agents & Developers

Vibe Springs is designed from the ground up to be used by autonomous agents. No human accounts, no credit cards — just pure x402 micropayments.

OpenAPI Spec (JSON)Bazaar Catalog

Hosted MCP Server

The fastest way in: one hosted endpoint, 22 curated tools, nothing to install. Free tools (health, search_services) work immediately; paid tools return x402 payment requirements on the first call — sign with your wallet and retry with payment_signature.

Claude Code

claude mcp add -t http vibesprings \
  https://vibesprings.net/mcp

Claude Desktop / Cursor

{ "mcpServers": {
  "vibesprings": {
    "type": "http",
    "url": "https://vibesprings.net/mcp"
  } } }

Paying over MCP

# 1. call get_forecast → payment_required + requirements
# 2. sign exact-scheme USDC auth (@x402/fetch does this)
# 3. call get_forecast again with payment_signature
# cheapest live test: get_delay_risk_demo ($0.002)

Framework Quick-Starts

Ready-to-use prompts and tool definitions for the most popular agent frameworks.

LangGraph / LangChain

Use the OpenAPIToolkit to automatically ingest our 41 services.

# Ingest the entire Vibe Springs suite
toolkit = OpenAPIToolkit.from_url(
  "https://vibesprings.net/api/openapi.json"
)

OpenAI Swarm

Ideal for multi-agent systems where one agent handles payments.

# System Prompt for your Weather Agent
"You are a weather specialist. When asked for data,
call the Vibe Springs API. If you get a 402,
delegate to the PaymentAgent to sign the USDC tx."

TypeScript (x402-fetch)

The x402 handshake in three lines — works for all 49 endpoints.

// npm i @x402/fetch viem
const fetchPaid = wrapFetchWithPayment(fetch, account);
const res = await fetchPaid(
  "https://vibesprings.net/api/forecast?location=Tokyo");

Python (x402)

Same handshake via the official Python client.

# pip install x402 eth-account
session = x402_requests(account)
r = session.get(
  "https://vibesprings.net/api/gas?chain=base")

Agent Decision Logic

Help your agents choose the right tool for the job.

Scenario: Multi-currency invoice for a global SaaS client.
Logic: Call /api/workflow/invoice-fx with line items in USD, EUR, and GBP � get a single PDF invoice converted to the client's preferred currency.
Scenario: DeFi portfolio rebalancing agent needs current prices.
Logic: Call /api/crypto for live token prices + /api/exchange/convert to value holdings in fiat + /api/exchange/history for trend analysis.
Scenario: Automating expense reports for a digital nomad.
Logic: Call /api/exchange/history for historical forex rates on travel dates + /api/exchange/convert to normalize amounts + /api/generate-pdf to render the final report.
Scenario: Analyzing global risk for a logistics route.
Logic: Call /api/exchange for currency exposure + /api/earthquakes for seismic risk + /api/flood for river levels + /api/forecast for weather conditions.
Scenario: Construction company scheduling equipment rental.
Logic: Call /api/delay-risk with profile ground_work to compute a 0-100 disruption score and estimate workable days remaining before renting expensive excavators.

Real-World Agent Stories

The Travel Sentinel Agent

"An autonomous research agent used our **Earthquake + Flood** data to monitor 500+ global warehouses. When it detected a M5.2 tremor in Osaka, it instantly pulled the local flood risk to determine if coastal storage was compromised — all without any human intervention or credit card on file."

The Multi-Chain Auditor

"A CrewAI swarm uses our **CSV Processing + PDF Generation** tools to audit monthly on-chain transactions. The 'Auditor' agent cleans the raw CSV data, while the 'Reporter' agent transforms it into a professional, signed PDF receipt for stakeholders."

Standing Loops

The cheapest way to use Vibe Springs is on a schedule. Register once, check on change — instead of paying full price to re-poll data that hasn't moved. Check reliability first: GET /api/health (free) or the live status page.

1. Morning Market Brief

One call replaces four: crypto + FX + gas + DeFi yields.

# cron: 0 7 * * * — $0.02/day
GET /api/market-pulse
# then only deltas since your last call:
GET /api/market-pulse?since=last

2. Price / Gas Alerting

POST /api/watch/register
{ "kind": "price", "target": "btc-usd",
  "condition": { "op": "changes", "field": "price" } }
# cron: */15 * * * * — $0.02/check
GET /api/watch/check-batch?ids=id1,id2,id3

3. Weekly Spend Self-Audit

Resolve your wallet's USDC outflows to named merchants across the whole x402 ecosystem.

# cron: 0 8 * * 1 — $0.10/week
GET /api/report/agent-spend
  ?address=0xYOUR_WALLET&days=7