The net.vibesprings/x402-tools server provides pay-per-use tools for weather, environment, finance, and on-chain intelligence, designed for AI agents via the x402 framework. It exposes multiple capabilities through a single server interface, enabling modular tool access.

🛠️ Key Features

Pay-per-use model for tool access
Weather, environment, finance, and on-chain intelligence tools
AI agent integration via x402
Centralized tool catalog with diverse data sources

🚀 Use Cases

AI agents requesting weather or environmental data
Financial data queries and analysis
On-chain intelligence and blockchain insights
Modular tool access via pay-per-use pricing

⚡ Developer Benefits

Consolidated tool suite under one server
Clear usage model aligned with x402 integration
Reusable components for agent-driven workflows

⚠️ Limitations

Specific tool counts and exact capabilities not detailed
Pricing and usage quotas not specified in the source data
Readme excerpt not provided for deeper implementation guidance

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 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 49 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.05	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.03	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.02	Wallet profiling: balances, tokens, activity, behavior tags.
`get_risk_report`	$0.03	On-chain due-diligence report (6+ risk signals).

Composite (one call, many sources)

Tool	Price	Description
`get_market_pulse`	$0.02	Crypto + FX + gas + DeFi yields in a single call.
`get_travel_brief`	$0.02	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.05	Historical metrics & pricing momentum for a Bazaar tag.
`get_bazaar_competitors`	$0.10	Closest competitor listings by tag/semantic overlap + your rank.
`audit_agent_visibility`	$0.20	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:

Call the tool without payment_signature → the response is a structured payment_required object with the exact x402 requirements (price, payTo, asset, nonce).
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)

License

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

q	string	optional	Keyword query, e.g. "weather", "wallet", "pdf"
category	string	optional	Category filter, e.g. "data/weather", "market-intelligence"
max_price	number	optional	Only services at or below this USDC price

location	string	required	City name or region
days	number	optional	Forecast days
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

location	string	required	City name or region
start_date	string	required	Start date YYYY-MM-DD
end_date	string	required	End date YYYY-MM-DD (max 90 days range, must be yesterday or earlier)
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

lat	number	required	Latitude of the site (US coverage)
lon	number	required	Longitude (US coverage)
profile	string	optional	Activity profile: ground_work \| outdoor_event \| logistics \| aerial
days	number	optional	Forecast window in days
soil	string	optional	Soil type if known: clay \| silt \| sand \| rock \| mixed
hydrologicGroup	string	optional	NRCS hydrologic soil group (A-D, or dual)
drainageClass	string	optional	NRCS drainage class
gradient	string	optional	Site slope: flat \| moderate \| steep
exposure	string	optional	Sun exposure: open \| shaded
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

location	string	optional	Demo location key: nova \| houston \| seattle \| denver \| miami
profile	string	optional	Activity profile
soil	string	optional	Soil type override
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

base	string	optional	Base currency ISO code (e.g. USD, EUR, GBP)
to	string	optional	Comma-separated target currencies. Omit for all.
date	string	optional	YYYY-MM-DD for historical rate
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

from	string	required	Source currency ISO code (e.g. GBP, USD)
to	string	required	Target currency ISO code (e.g. JPY, EUR)
amount	string	optional	Amount to convert
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

ids	string	optional	Comma-separated CoinGecko IDs (e.g. bitcoin,ethereum). Omit for top coins.
vs	string	optional	Quote currency: usd, eur, gbp, jpy, btc, eth
limit	number	optional	Max results
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

topic	string	optional	Comma-separated keywords (e.g. bitcoin,ethereum)
since	string	optional	ISO timestamp or shorthand 1h, 6h, 24h
limit	number	optional	Max articles (1-50)
minSentiment	number	optional	Min sentiment score (-1 to 1)
maxSentiment	number	optional	Max sentiment score (-1 to 1)
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

token	string	optional	Filter by token symbol (e.g. USDC, ETH, WBTC)
chain	string	optional	Filter by chain: base, ethereum, arbitrum, optimism. Omit for all chains.
min_tvl	number	optional	Minimum TVL in USD
limit	number	optional	Max results
sort	string	optional	Sort by: apy, tvl, or protocol
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

address	string	required	Ethereum address (0x...)
chain	string	optional	Network: ethereum, base, or sepolia
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

cryptos	string	optional	Comma-separated CoinGecko token IDs (default: top 10 by market cap)
base	string	optional	Base fiat currency for FX rates
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

kind	string	required	price \| gas \| weather \| wallet \| endpoint
target	string	required	Symbol (e.g. BTC-USD), chain (base), location (London), address, or URL
condition	object	required	{ op: gt\|lt\|crosses\|changes, field: string, value?: number }
notify	object	optional	{ email?: string }
authorizedPayers	array	optional	Array of additional addresses allowed to check this watch
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

id	string	required	The watchId to check
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

ids	string	required	Comma-separated watch IDs to check
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

tag	string	required	Bazaar tag or category name
window	number	optional	Number of snapshot dates to trace (7-30)
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

resource	string	optional	Listing resource URL to analyze
payTo	string	optional	Merchant payTo address to analyze
limit	number	optional	Max competitors (1-25)
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

url	string	required	Target API endpoint URL to check
payment_signature	string	optional	Optional x402 payment token. Call the tool WITHOUT this first to receive payment requirements (price, payTo, asset, nonce rules), sign the exact-scheme EIP-712 USDC authorization with your wallet, then retry with this field set to the base64 token.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

health

search_services

get_forecast

get_weather_history

get_delay_risk

get_delay_risk_demo

get_exchange_rates

convert_currency

get_crypto_prices

get_crypto_news

get_defi_yields

get_gas_prices

get_wallet_intel

get_risk_report

get_market_pulse

get_travel_brief

register_watch

check_watch

check_watches_batch

get_bazaar_category_trends

get_bazaar_competitors

audit_agent_visibility