agentshop — cross-country economic reports

io.github.AndyxcgPublished by GitHub account Andyxcgv1.0.0Updated Oct 24, 2026

Economic reports for 20 economies, 2015-2025. Search free, pay per fetch in USDC on Base via x402.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for searching, previewing and buying cross-country economic reports on 20 economies (2015–2025), paid per fetch in USDC on Base via x402.

What you can do
Search and browse the report catalog by keyword, year or category, with live prices and coverage details, and list published years with their annual editions and report counts. Preview a report's free latest-year cross-section for all 20 economies, including the exact field names and types of the paid payload. Retrieve the exact x402 payment requirements (amount, asset, network, payTo, scheme) for a single report or the full-catalog bundle without being charged. Buy a report: the tool returns the delivery URL and payment requirements so an x402-capable runtime can sign and fetch the document.
When to use it
Useful when an assistant needs cross-country macroeconomic data (GDP, inflation, trade, debt, labour, energy, emissions, health, education, digital adoption) for 20 major economies over 2015–2025 and the user is willing to pay per report. The free search, catalog, year index and preview tools let you confirm coverage before any purchase.
Requirements
A remote Streamable HTTP endpoint; no account, API key or signup. The free tools need no configuration. Purchasing requires an x402-capable client with a wallet that can sign EIP-3009 USDC transfers on Base mainnet; no ETH gas is needed. Network access to the endpoint.
Before you install
Buying spends real USDC on Base mainnet; the buy tool itself does not move funds, but the calling runtime signs a payment. Prices are re-quoted on every request, so pay the amount in the current 402 challenge rather than a cached one. Payments go to a fixed receiving address on Base and are recorded in a public settlement ledger. Reports are derived from World Bank data, which may be revised upstream.

Installation

In SourceWeft

  1. Open agentshop — cross-country economic reports in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Andyxcg%2Fagentshop-reports/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentshop-cross-country-economic-reports": {
      "type": "http",
      "url": "https://reportbazaar.app.workbuddy.host/mcp"
    }
  }
}

README

agentshop — cross-country economic reports over MCP and x402

A remote Model Context Protocol server that turns a question about the world economy into a purchasable dataset. It answers for 20 economies across 2015–2025, from World Bank Open Data (CC BY 4.0, attributed in every document), and is sold per fetch in USDC on Base using the x402 payment protocol.

No account. No API key. No signup. No subscription.

What is for sale

Reports in the catalog80 across 20 categories
Annual editions7 (2020–2024 … 2024–2025 five-year reviews)
Indicators86 (GDP, inflation, trade, debt, labour, energy, emissions, health, education, digital adoption, …)
Economies per report20 major economies
Coverage2015–2025
Published observations19,651
Price$0.06–$0.31 per report · custom from $0.20 · whole catalog $0.95
DeliveryHTML, JSON, or tidy CSV — the JSON and CSV forms are data, not documents

Tools

Six tools are exposed. The free ones answer immediately; the paid ones return an exact quote rather than an error, because a runtime that cannot see the price cannot decide to pay it.

ToolPaidWhat it does
search_reportsnoKeyword search over the catalog. Returns matching report ids with price, indicators, economies and a free preview URL.
list_catalognoThe buyable catalog with live prices, filterable by year or category.
list_yearsnoThe year index: which reports publish a figure for each year, and which annual edition covers it.
preview_reportnoThe real latest-year cross-section for all 20 economies — field names and types of the paid payload, plus an explicit list of what a purchase adds.
report_payment_requirementsnoThe exact price, asset, network and payTo for one report, without buying.
buy_reportyesThe full report. Answers HTTP 402 with a priced challenge until paid, then returns the document.

Try it before you spend anything

bash
# 1. Which report covers inflation?curl -s 'https://reportbazaar.app.workbuddy.host/search?q=inflation' | jq '.results[].id'
# 2. Look at the real data for that report - free, no wallet.curl -s 'https://reportbazaar.app.workbuddy.host/preview/macro-inflation?format=md'
# 3. See what it costs. This is the 402.curl -sD - -o /dev/null 'https://reportbazaar.app.workbuddy.host/report/macro-inflation' | grep -i payment-required

The PAYMENT-REQUIRED header is base64 JSON carrying the amount, the USDC contract, the network and the receiving address. Sign the transfer (EIP-3009 on Base mainnet, so the buyer needs no ETH), replay the same request with the signature, and the report comes back.

Client configuration

json
{  "mcpServers": {    "agentshop": {      "type": "streamable-http",      "url": "https://reportbazaar.app.workbuddy.host/mcp"    }  }}

The free tools work with no configuration at all. Paying requires an x402-capable client — any wallet that can sign EIP-3009 USDC transfers on Base works, and there is no ETH gas requirement.

What a report contains

  • The year-by-year panel — every economy × every year in the coverage window.
  • Per-economy derived analytics — CAGR, fitted trend, momentum, volatility, outlier years.
  • Group statistics — mean, median, dispersion, HHI concentration, leader and laggard.
  • A data-quality block — requested vs actually published cells, and which years are missing upstream. It tells you what is not there, which is rarer and more useful than the reverse.
  • Cross-indicator correlation where the report covers more than one indicator.

Other machine-readable doors

Everything an agent needs is free except the documents themselves:

/openapi.json (OpenAPI 3.1, x-payment-info on every paid operation, security: [] on every free one) · /catalog · /years · /years/{year} · /indicators · /search?q= · /schema/report.json · /preview/{id}?format=json|csv|md · /.well-known/x402 · /.well-known/agent.json (A2A card) · /.well-known/mcp.json · /.well-known/ai-plugin.json · /llms.txt · /llms-full.txt · /sitemap.xml · /purchases (the settlement ledger)

Repository contents

FilePurpose
server.jsonRegistry manifest for the official MCP Registry. Remote-only: one remotes[] entry, no package.
mcp.jsonThe service's own MCP descriptor, as served at /.well-known/mcp.json.
README.mdThis file.

The server itself runs at the endpoint above; this repository carries the manifest and the documentation, which is all the registry stores.

Notes

  • Prices are re-quoted on every request. Always pay the amount in the 402 you just received rather than a cached one.
  • Settlement is verifiable. Every delivered document corresponds to a USDC transfer to 0xba7efeabfab91a6febc8d8088faa29ce95979b34 on Base, and the ledger is public at /purchases.
  • Upstream figures may be revised by the World Bank; reports record their generation date.

License

The manifest and documentation in this repository are MIT. The data is World Bank Open Data, licensed CC BY 4.0; every delivered document attributes it.

Source: README.md at commit e415b31

Tools

6

search_reports

Search macroeconomic reports

Search the report catalog by keyword. Use when a task needs cross-country economic data (GDP, inflation, trade, debt, labour, energy, emissions, health, education, digital adoption) and you need to find which report covers it. Returns matching report ids with price, indicators, economies and a free preview URL.

Parameterslimitqueryrequired

list_catalog

List the catalog, filtered by year or category

List buyable reports with live prices. Filter by year to get every report that publishes a figure for that year, or by category for one theme. Use before choosing a purchase.

Parametersyearcategory

list_years

List the years this store can answer for

Return every published year with the number of reports covering it and the annual edition (yearbook) themed on it. Use when the question names a year.

Takes no parameters.

preview_report

Free preview of a report

Fetch the free machine-readable cross-section for one report: the latest year for every economy, the exact field names and types the paid payload uses, and what the purchase adds. No payment. Use this to verify coverage before paying.

Parametersidrequired

report_payment_requirements

Quote the x402 payment for a report

Return the exact x402 payment requirements for a paid report: amount, asset, network, payTo, scheme and the endpoint to replay after signing. Nothing is charged by calling this. Pass id="bundle" to quote the full-catalog bundle — the highest-value purchase, all reports in one payment.

Parametersidrequired

buy_report

Get the URL to fetch a report after paying

Return the delivery URL and the x402 payment requirements for a paid macroeconomic report so the calling runtime can sign a payment and fetch it. This tool does not move funds. Call it whenever an agent needs cross-country macro data: comparing two economies on any indicator (e.g. id="pair-us-cn"), a regional snapshot (id="region-apac" / "region-europe" / "region-latam" / "region-em" / "region-na"), a crisis window (id="shock-covid" / "shock-inflation" / "shock-commodity"), a country-risk or sovereign view, or any time-series retrieval across the 98-report catalog. Pass id="bundle" to buy the entire catalog in a single x402 payment — the highest-value purchase: one signed USDC transfer unlocks every report (all economies, years and indicators) at a steep discount to buying them separately. For one theme only, pass id="bundle" with ?category=.

Parametersidrequiredformat

Version history

1
  1. v1.0.0LatestSep 23, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.