What is x402 here?
A paid, agent-native counterpart to the human Telegram experience.
x402 is an open HTTP 402 payment standard. An agent calls our API; an unpaid request returns 402 Payment Required, the agent settles the charge automatically in a USD stablecoin (USDC by default) on an EVM chain, and the request completes. No API keys to provision, no invoices, no human in the loop — just a funded wallet.
How an agent uses it
GET /api/agent/coverage?lat=&lng= returns honest nearby POI counts, the chapters that would be generated, and a coverage_level so you never pay for a thin report.
POST /api/agent/reports with {lat, lng, language}. The x402 layer settles payment and you receive a job_id.
GET /api/agent/reports/{job_id}; poll until ready, then read the report as Markdown plus metadata.
What a paid order returns
A single Markdown document of ~20 parcel-level chapters, compiled only from official/authoritative sources — not a generic area summary.
- Hazards & riskflood risk (SNCZI), seismic zoning, radon potential (CSN), wildfire risk (EFFIS), mold risk, lightning density.
- Climate & environmentclimate normals (AEMET/ERA5), wind rose, solar-PV potential (PVGIS), air quality (EEA), pollen, light pollution, coastal sea-level rise.
- Land & positioncadastral identity, elevation/slope/aspect, historical-maps overlay.
- Access & communitycritical-infrastructure proximity, public-transport access, tourism/culture/events, neighbourhood sentiment from real nearby reviews.
Get the agent skill
Ready-to-use packages for Claude Agent Skills, MCP clients, OpenAI/ChatGPT tools, and any agent framework (standalone x402 buyer CLI).
GitHub — Parcelabot x402 report skill
https://github.com/pavelmiljutin-beep/fincaparticular/tree/main/x402-report-skill
Includes the API reference, coverage-first flow, payment setup, and drop-in clients. Base URL: https://parcelabot.duckdns.org.
Quick start
curl "https://parcelabot.duckdns.org/api/agent/coverage?lat=40.4168&lng=-3.7038"
curl -X POST "https://parcelabot.duckdns.org/api/agent/reports" \
-H "Content-Type: application/json" \
-d '{"lat":40.4168,"lng":-3.7038,"language":"en"}'
# -> 402 Payment Required; an x402 client retries with a signed payment header
x402 client SDKs handle the 402 challenge and payment signature automatically. See the GitHub repo for a funded-wallet setup and language options.