Documentation

Connect munge to your agent

One MCP endpoint, ten public-data sources, OAuth or API-key auth. Connect Claude, Cursor, or any MCP-compatible client in under a minute.

Setup

The fastest path: let Claude Code register itself via OAuth.

claude mcp add --transport http munge https://munge.sh/mcp

Claude will open a browser window for you to sign in. Once approved, the munge tools become available — no copy-paste, no keys to manage.

Using an API key

For clients that don't speak OAuth (Cursor, Cline, custom code):

  1. Go to your dashboardAPI keysGenerate.
  2. Copy the key — it's shown once.
  3. Pass it as Authorization: Bearer <key> on every MCP request.

Manual JSON config

{
  "mcpServers": {
    "munge": {
      "url": "https://munge.sh/mcp"
    }
  }
}

Data sources

munge talks to ten public-data APIs through a single MCP surface. No keys to register per-source, no rate limits to track yourself.

SEC EDGAR
US public-company filings, XBRL facts, concept queries.
World Bank
Macro indicators for every country and region.
Eurostat
European macroeconomic and demographic series.
ECB
European Central Bank reference rates and statistics.
OpenStreetMap
Geocoding, reverse geocoding, and place lookup.
Open-Meteo
Weather forecasts and historical climate data.
Brønnøysund
Norwegian company registry and corporate records.
SSB
Statistics Norway — population, economy, environment.
NVE
Norwegian hydrology, electricity, and energy markets.
DSF (kartverket)
Norwegian property, address, and cadastral data.

Tools

Every MCP tools/call costs 1 credit. Free actions like tools/list and initialize don't. You get 100 credits free each month.

  • companies.lookup — search and resolve a company by name, country, or ID.
  • companies.filings — list recent SEC filings for a US ticker.
  • geo.geocode — convert an address to coordinates.
  • geo.reverse — convert coordinates to a place.
  • macro.indicator — fetch a World Bank/Eurostat series.
  • weather.forecast — 7-day forecast for a location.
  • weather.history — historical observations.
  • filings.concept — pull a single XBRL concept across a company's filings.

A full machine-readable catalog is available via tools/list on the MCP endpoint, or signed in on the dashboard.

Authentication

munge implements OAuth 2.1 with PKCE and RFC 7591 dynamic client registration. Public discovery endpoints:

Need to manage your authorized apps? Visit your dashboard.