# Vibe Springs — agents.txt
# https://vibesprings.net
# Last updated: 2026-07-12

Name: Vibe Springs
Description: 49 pay-per-use AI endpoints on Base mainnet via x402 protocol. Weather, finance, blockchain, social intelligence, agent infrastructure, composites, workflows, and processing tools. No API keys, no subscriptions — just micropayments.
Url: https://vibesprings.net
Contact: support@vibesprings.net
Provider: Vibe Springs / Ilyistics LLC

# Discovery (all FREE, no payment required)
Catalog: https://vibesprings.net/api/catalog
Health: https://vibesprings.net/api/health
Status-Page: https://vibesprings.net/status
Listing-Health: https://vibesprings.net/api/audit/listing-health (merchant self-check, 3/day/IP)
OpenAPI: https://vibesprings.net/openapi.yaml
OpenAPI-JSON: https://vibesprings.net/openapi.json
LLMs-txt: https://vibesprings.net/llms.txt
LLMs-full-txt: https://vibesprings.net/llms-full.txt
x402-Manifest: https://vibesprings.net/.well-known/x402.json
MCP-Manifest: https://vibesprings.net/.well-known/mcp.json
AI-Plugin: https://vibesprings.net/.well-known/ai-plugin.json

# Hosted MCP Server (streamable-http, stateless — no install, no API keys)
MCP-Endpoint: https://vibesprings.net/mcp
MCP-Tools: 22 (free: health, search_services; paid tools use 402-over-MCP with payment_signature retry)
MCP-Connect-ClaudeCode: claude mcp add -t http vibesprings https://vibesprings.net/mcp

# Payment
Protocol: x402
Network: eip155:8453 (Base Mainnet)
Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Facilitator: https://api.cdp.coinbase.com/platform/v2/x402
PayTo: 0x38C063312719220c676E988f0DEE14B4ec0e44C8
Price-Range: $0.00 - $1.00 USDC

# Terms
Data-Usage: allowed
Training: allowed
Caching: allowed (24h recommended TTL)
Attribution: appreciated but not required

# Service Categories (49 endpoints total)
## data/weather (9 endpoints, $0.002-$0.05/call)
- GET /api/weather — Historical weather data for any location
- GET /api/forecast — Up to 16-day weather forecast
- GET /api/air-quality — Current and forecast air quality (PM2.5, PM10, ozone)
- GET /api/marine — Marine weather, wave heights, swells, currents
- GET /api/earthquakes — Global seismic activity monitoring (USGS)
- GET /api/flood — Flood risk and river discharge levels
- GET /api/solar — Solar radiation, astronomy, UV index
- GET /api/delay-risk — Weather-driven scheduling disruption risk score ($0.05)
- GET /api/demo/delay-risk — Demo: delay risk score for 5 fixed US locations ($0.002)

## data/finance (6 endpoints, $0.002-$0.005/call)
- GET /api/exchange — Live ECB forex rates for 30+ currencies ($0.002)
- GET /api/exchange/convert — Cross-rate currency converter ($0.002)
- GET /api/exchange/history — Daily rate time series up to 365 days ($0.005)
- GET /api/crypto — Live crypto prices, market caps, volume ($0.005)
- GET /api/market-data — Unified stock and crypto market feed ($0.002)
- GET /api/holidays — Public holidays by country ($0.002)

## data/blockchain (7 endpoints, $0.001-$0.005/call)
- GET /api/gas — Real-time gas fees for Base, ETH, Arbitrum, Optimism ($0.001)
- GET /api/wallet-intel — Full wallet profiling and behavioral tags ($0.02)
- GET /api/defi-yields — Cross-protocol yield scanner ($0.03)
- GET /api/price/btc-usd — Real-time BTC/USD price oracle ($0.002)
- GET /api/price/eth-usd — Real-time ETH/USD price oracle ($0.002)
- GET /api/price/sol-usd — Real-time SOL/USD price oracle ($0.002)
- GET /api/price/base-gas — Real-time Base gas price oracle ($0.001)

## mock/social (2 endpoints, $0.005-$0.01/call)
- GET /api/mock/social/feed — Mock social feed with persona/sentiment/seed/format controls ($0.005)
- GET /api/mock/social/stream — Mock stream scenarios (hype cycle, FUD cascade, etc.) ($0.01)

## tools (4 endpoints, $0.01-$0.04/call)
- POST /api/alert — Secure email alerts to operators ($0.01)
- POST /api/generate-pdf — Professional PDF document generation ($0.04)
- POST /api/convert-image — Image conversion and optimization ($0.02)
- POST /api/process-csv — CSV data cleaning and analysis ($0.01)

## data/news (2 endpoints, $0.008-$0.02/call)
- GET /api/news/crypto — Aggregated crypto news and sentiment feed ($0.008)
- GET /api/news/pulse — Coverage volume velocity and sentiment pulse ($0.02)

## accounting-tools (1 endpoint, $0.10-$0.25/call)
- GET /api/report/agent-spend — Outflow resolution and merchant audit ($0.10 JSON / $0.25 PDF)

## market-intelligence (2 endpoints, $0.05-$0.10/call)
- GET /api/trends/category — Category stats and pricing guidance ($0.05)
- GET /api/trends/competitors — Competitor set and similarity ranking ($0.10)

## workflows (3 endpoints, $0.008-$0.06/call)
- GET /api/workflow/location-report — Weather + air + solar combined ($0.008)
- POST /api/workflow/invoice-fx — Multi-currency invoice + PDF ($0.05)
- POST /api/workflow/csv-to-pdf — CSV processing + PDF report ($0.06)

## composite (4 endpoints, $0.02-$0.03/call)
- GET /api/market-pulse — Crypto + FX + gas + DeFi in one call ($0.02)
- GET /api/travel-brief — Forecast + air + holidays + FX ($0.02)
- GET /api/portfolio-brief — Wallet + risk + yields + gas ($0.03)
- GET /api/risk-report — 6-signal risk score + wallet profile ($0.03)

## security (1 endpoint, $0.005/call)
- GET /api/address-risk — On-chain security score (0-100)

## agent-infrastructure (5 endpoints, FREE-$0.20/call)
- GET /api/health — Service health + 7-day reliability aggregates (FREE)
- GET /api/agent/status — Agent wallet status and recommendations ($0.005)
- GET /api/infra/health-check — API health and x402 compatibility scanner ($0.003)
- GET /api/audit/agent-visibility — AEO/GEO Agent Visibility Auditor ($0.20)
- GET /api/audit/listing-health — Bazaar merchant listing health report (FREE, 3/day/IP)
- GET /api/infra/discover — Dynamic catalog search and filtering ($0.005)
## monitoring/watch (4 endpoints, $0.00-$0.02/call)
- POST /api/watch/register — Register a watch condition ($0.01)
- DELETE /api/watch/register — Cancel and delete a watch spec ($0.00)
- GET /api/watch/check — Poll/check watch condition by ID ($0.008)
- GET /api/watch/check-batch — Batch check up to 5 watch conditions ($0.02)