StatePulse API
Retrieves live funding rates and pricing for perpetual swap contracts from Binance.
Queries DNS propagation status and security records using Cloudflare's DNS over HTTPS.
Resolves smart contract ABIs and checks wallet balances on Ethereum and Base.
Accesses active wildfire reports and satellite fire alerts from NASA FIRMS.
StatePulse API
Pay-per-call live telemetry, environmental metrics, transit state vectors, and real-time utilities for AI agents. Narrow, machine-readable agent unblockers for coordinates, speed, air quality, weather anomalies, DNS record propagation, and bank holidays that agents need but can't reliably guess.
MCP Server
StatePulse API is available as a remote MCP server — point any MCP client at:
https://statepulse-api.hahavoid0.workers.dev/mcpTransport: streamable HTTP
Auth: none (paid tools settle via x402 USDC on Base, per call)
Tools exposed: 50
Metadata: https://statepulse-api.hahavoid0.workers.dev/.well-known/mcp.json
Related MCP server: aipaygen-mcp
Commercial Endpoints
Endpoint | Price | Purpose |
|
| Resolves a UPC/EAN or ISBN barcode into detailed product metadata using OpenLibrary and UPCitemdb free search endpoints. |
|
| Queries live airspace vectors for a specific aircraft ICAO24 hex identifier or a regional bounding box using OpenSky Network. |
|
| Retrieves live localized air quality indices (AQI) and pollutant levels for a given latitude/longitude using OpenAQ. |
|
| Check transit delays, active alerts, and schedule status updates for supported cities and lines. |
|
| Compares current weather conditions with a 10-year historical average to flag climate anomalies. |
|
| Resolves direct Shoutcast/Icecast streaming URLs from an open-source radio station database by country or tag. |
|
| Checks global MX, TXT, A, and CNAME propagation status using Cloudflare DoH endpoints. |
|
| Extracts brand logos and theme colors for any public business URL using Clearbit and HTML parsing. |
|
| Retrieves live betting market prices and contract odds for global geopolitical events using PredictIt. |
|
| Queries live US river level, streamflow gauge height, and flow velocity metrics using the USGS National Water Information System. |
|
| Retrieves local bank and public holidays across 100+ countries to verify business days. |
|
| Queries the USGS Earthquake Hazards API for recent earthquakes exceeding a minimum magnitude. |
|
| Scans active wildfire reports and incidents via public NASA FIRMS satellite active fire alert feeds to locate active blazes. Matches: active wildfire detector, NASA FIRMS fire coordinates, forest fire satellite alert, wildfire tracking map, satellite burn zones detector. |
|
| Retrieves the current planetary K-Index and active solar storms from NOAA SWPC. Matches: space weather solar storm alert, planetary k-index monitor, geomagnetic activity tracker, solar flare satellite warnings, coronal mass ejection tracking. |
|
| Queries pollen allergen index counts (grass, birch, oak) by coordinate using Open-Meteo. |
|
| Fetches live observation data for a specific NOAA marine buoy station. |
|
| Scans active USGS gauge heights in a US state for potential river flooding. Matches: streamflow flood alerts, USGS gauge height warnings, river level flood checker, water streamflow warnings, river overflow stage alerts. |
|
| Retrieves the current solar UV Index and calculates sun safety burn times. |
|
| Queries the hourly lightning potential indices for coordinates. |
|
| Resolves the current coordinate telemetry and voyage details for a cargo ship by MMSI number. Matches: cargo ship location tracker, AIS transponder coordinate lookup, find container vessel by MMSI, ocean logistics cargo positioning, track shipping container vessel, sea lanes transit tracker. |
|
| Queries live train departures and schedule delays for European transit hubs using transport.opendata.ch. |
|
| Estimates the approximate toll road costs for a route based on distance and state-level averages. Matches: toll road pricing, toll calculator, toll highway fees, driving trip expense calculator, truck route toll cost checker, logistics delivery overhead. |
|
| Locates public electric vehicle charging stations within a given radius using Open Charge Map. |
|
| Computes the shortest driving distance and duration between two coordinates using the public OSRM engine. |
|
| Retrieves the recent live arrivals list for a specific airport by ICAO code. Matches: airport arrivals board list, check arriving aircraft, OpenSky schedule flight landing board, flight terminal details. |
|
| Queries the FAA public API for active delays, ground stops, and weather statuses for a US airport. Matches: air traffic control delays, US airport ground stops, flight weather delays, FAA flight restrictions, airport layout status. |
|
| Locates the combined sales tax rate (state, county, local) for a US ZIP code using Zippopotam. Matches: sales tax rate calculator, zip code tax lookup, commercial sales tax checker, e-commerce tax estimator, state county city tax rates. |
|
| Queries the official public USPTO PatentsView database to fetch status and info for a patent. Matches: USPTO patent lookup, search patent number info, patent inventor checker, patent filing date tracker, technology patent registry search. |
|
| Performs a preliminary conflict check on a word against public trademark registries. Matches: trademark check, brand conflict check, domain availability name checker, intellectual property brand screening. |
|
| Parses the Nasdaq Trader RSS feed for active or recent stock trading halts. |
|
| Retrieves the current federal funds target interest rate. |
|
| Searches public business registries (e.g. OpenCorporates and SEC EDGAR databases) to retrieve registered address, incorporation date, jurisdiction, and official status. Matches: corporate registration check, company status finder, look up business incorporation details, verify corporate address lookup. |
|
| Resolves the contract interface JSON (ABI) for verified smart contracts on Base or Ethereum. Matches: get verified smart contract source interface, Basescan verified ABI fetcher, Etherscan contract JSON interface loader, decode transaction calldata helpers, verified contract methods parser. |
|
| Runs eth_call state simulation against the Base blockchain RPC to check for transaction reverts. Matches: EVM revert checks, test contract call, inspect transaction failure, dry-run solidity method, gas estimator, test token swap failure, simulate multisig transaction execution. |
|
| Scans recent block gas details to estimate the minimum, average, and maximum base fee. |
|
| Scans native balance and ERC-20 token balances for a wallet address on Base or Ethereum. |
|
| Queries current pricing and funding rate margins for perpetual swap contracts from Binance. |
|
| Relays a transaction to Base Mainnet, paying the native gas on your behalf and charging your wallet equivalent USDC via EIP-3009 receiveWithAuthorization. Matches: gasless tx relayer, submit transaction base, pay gas in usdc. |
|
| Deposits a real USDC bounty on Base using EIP-3009 receiveWithAuthorization, locking it in the non-custodial EscrowRegistry contract. Matches: deposit onchain bounty, non-custodial escrow bounty, lock usdc bounty. |
|
| Triggers the EscrowRegistry contract to release a locked USDC bounty to a worker wallet. Releasing can only be authorized by the StatePulse hot wallet (owner). Matches: release onchain bounty, payout escrow bounty, resolve locked bounty. |
|
| One call that pre-flights an onchain transaction for an agent: simulates the call for reverts, checks the sender wallet's native gas balance, and reads current Base gas — returning a single GO/NO_GO verdict with reasons. Replaces 3 separate calls (simulate + balances + gas-history) every agent runs before transacting. Matches: pre-transaction check, agent transaction guard, revert + balance + gas preflight, onchain go/no-go, safe-to-send checker, autonomous trade preflight. |
|
| Queries DNSSEC (DS) and Certification Authority Authorization (CAA) records for a domain using Cloudflare DoH. |
|
| Extracts certificate validity dates and expiration countdown for a domain using CertSpotter logs. |
|
| Fetches target URL headers to score configurations (HSTS, CSP, X-Frame-Options). |
|
| Resolves the local time, offset, and daylight savings status for a city name using Open-Meteo Geocoding. |
|
| Queries live stream water temperature telemetry from active USGS gauges in a US state. |
|
| Queries the global RDAP bootstrap directory for domain registration details, registrar name, creation date, and expiration timestamp. Matches: domain registration checker, WHOIS lookup tool, check domain owner registry, check website expiry date. |
|
| Scans an IPv4 or IPv6 address using public geodata to resolve location, country, ISP, autonomous system, and hosting flags. Matches: geolocate IP address, check client IP country, query ISP metadata, threat intelligence proxy check, hosting provider detector. |
Every endpoint also responds to GET <path> (no payment) with its schema, description, and example input/output, and is fully described in /openapi.json and /llms.txt.
The current registry exposes 44 paid micro-endpoints. See AGENT_DISCOVERY_PLAYBOOK.local.md for the private discovery and checklist.
Agent-First Architecture
Protocol | Spec Location / Endpoint |
LLMs Text |
|
OpenAPI 3.1.0 |
|
x402 |
|
MCP |
|
A2A |
|
OASF |
|
EIP-8004 |
|
Local Development
npm install
npm run dev
npm run typecheckDeployment
npm run deployThis deploys to the statepulse-api Cloudflare Worker at https://statepulse-api.hahavoid0.workers.dev.
Payment
Paid endpoints use x402 on Base with USDC. Unpaid requests to paid routes return HTTP 402 Payment Required with a standard payment challenge.
Example paid call:
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/weather/anomaly -m POST -b '{"lat":40.71,"lng":-74.00}'npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/product/barcode -m POST -b '{"barcode":"9780140449136"}'See buyer/README.md for local x402 buyer testing.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ahmed-Achtatar/statepulse-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server