Lighthouse

An MCP gateway for AI-led commodity trading agents. Exposes commodity, location, and market data as a single set of tools over the Model Context Protocol.

Available services

FX fx
Foreign exchange rates and Brazilian macro. Two halves, always labelled: a LIVE PROXY to Frankfurter v2 (ECB + national-bank reference rates, nothing stored) and STORED HISTORY from BCB SGS — the official PTAX USD/BRL fixing back to 1984 with both sides of the quote, plus Selic, IPCA and international reserves. PTAX and the ECB cross are different instruments; compare_brl_sources shows both on one date.
https://services.lighthouse-mcp.com/mcp/fx
Locations locations
Cross-source location queries — resolve names/codes to places, reverse-geocode points, find nearby ports, look up admin polygons. Backed by Natural Earth, UN/LOCODE, and GADM.
https://services.lighthouse-mcp.com/mcp/locations
Weather weather
Weather and climate state. Two halves, always labelled: a LIVE PROXY to Open-Meteo for point weather (current conditions, 16-day forecast, ERA5 reanalysis — fetched on demand, nothing stored) and STORED HISTORY from NOAA CPC for climate regime (ONI, RONI, SOI back to 1950, plus a derived ENSO state read applying CPC's five-season threshold rule). Point weather answers "what is it like there"; the climate indices answer "what regime are we in" — ENSO drives Brazilian rainfall and Colombian harvest timing.
https://services.lighthouse-mcp.com/mcp/weather
Coffee demand coffee-demand
Trader-shaped read view over Lighthouse coffee-demand sources: EU Comext import flows, US GATS census import flows with an arabica/robusta tariff-line split, historical world bilateral lanes (frozen UN Comtrade mirror), USDA PSD supply-and-demand balances, Destatis Kaffeesteuer consumption proxy (when populated), and SEC EDGAR roaster operating metrics for the curated coffee universe (SBUX, KDP, LKNCY, SJM, QSR, BROS).
https://services.lighthouse-mcp.com/mcp/coffee-demand
Coffee supply coffee-supply
Trader-shaped read view over Lighthouse coffee-supply data. USDA PSD production & exports for every origin (with publish vintage); Brazil's two official crop estimators, CONAB and IBGE SIDRA, plus the spread between them; Cecafé's MEASURED monthly Brazilian shipments including the first measured conilon/robusta series; and FNC's Colombian production, exports and grower prices back to 1913. Flow-side sibling to Coffee demand.
https://services.lighthouse-mcp.com/mcp/coffee-supply
Coffee stocks coffee-stocks
Trader-shaped read view over the coffee inventory layers Lighthouse has: USDA PSD carryover (ending stocks, every origin) and IBGE declared BR warehouse stocks. Settles the S&D ledger — including get_stocks_divergence, which compares implied ΔStocks (PSD flows) against an INDEPENDENT observed source (never PSD-vs-PSD, which is tautological). Certified (ICE), warehouse (GCA), and corporate (SEC) layers are the next additions.
https://services.lighthouse-mcp.com/mcp/coffee-stocks
Coffee prices coffee-prices
Trader-shaped read view over Lighthouse's coffee PRICE layer — the level the rest of the platform's volume data trades at. ICO's benchmark complex in US cents/lb: the I-CIP composite, the four group indicators that ARE the physical market's segmentation (Colombian Milds, Other Milds, Brazilian Naturals, Robustas), and the New York + London futures averages, monthly and unbroken from 2011-10. Plus fifteen years of ICO's PUBLISHED price differentials — including new_york − london, the arbitrage — which the roadmap treats as broker-bulletin territory. Price-side sibling to Coffee supply, demand and stocks.
https://services.lighthouse-mcp.com/mcp/coffee-prices
SEC EDGAR sec
Horizontal proxy for U.S. SEC EDGAR — company info, filings, XBRL facts, financial statements, and insider trading. Works for any public registrant; commodity-specific layers (e.g. coffee-demand) call this service for their curated company universes.
https://services.lighthouse-mcp.com/mcp/sec

Connecting from your agent

Two options. The unified endpoint (/mcp) registers one MCP server with every tool prefixed by its service slug (e.g. fx_get_pair). The per-service endpoints (/mcp/fx, …) register each service as a separate MCP server with bare tool names. Use whichever fits your agent's UX.

Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json

Unified — one server, prefixed tools

{
  "mcpServers": {
    "lighthouse": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp"
    }
  }
}

Per service — N servers, bare tool names

{
  "mcpServers": {
    "lighthouse-fx": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/fx"
    },
    "lighthouse-locations": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/locations"
    },
    "lighthouse-weather": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/weather"
    },
    "lighthouse-coffee-demand": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/coffee-demand"
    },
    "lighthouse-coffee-supply": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/coffee-supply"
    },
    "lighthouse-coffee-stocks": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/coffee-stocks"
    },
    "lighthouse-coffee-prices": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/coffee-prices"
    },
    "lighthouse-sec": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp/sec"
    }
  }
}

Claude Code .mcp.json at your repo root, or ~/.claude/mcp.json globally

Unified

{
  "mcpServers": {
    "lighthouse": {
      "type": "http",
      "url": "https://services.lighthouse-mcp.com/mcp"
    }
  }
}

For per-service, use the same shape as Claude Desktop's per-service block above.

Codex ~/.codex/config.toml

Unified

[mcp_servers.lighthouse]
url = "https://services.lighthouse-mcp.com/mcp"

Per service

[mcp_servers.lighthouse-fx]
url = "https://services.lighthouse-mcp.com/mcp/fx"

[mcp_servers.lighthouse-locations]
url = "https://services.lighthouse-mcp.com/mcp/locations"

[mcp_servers.lighthouse-weather]
url = "https://services.lighthouse-mcp.com/mcp/weather"

[mcp_servers.lighthouse-coffee-demand]
url = "https://services.lighthouse-mcp.com/mcp/coffee-demand"

[mcp_servers.lighthouse-coffee-supply]
url = "https://services.lighthouse-mcp.com/mcp/coffee-supply"

[mcp_servers.lighthouse-coffee-stocks]
url = "https://services.lighthouse-mcp.com/mcp/coffee-stocks"

[mcp_servers.lighthouse-coffee-prices]
url = "https://services.lighthouse-mcp.com/mcp/coffee-prices"

[mcp_servers.lighthouse-sec]
url = "https://services.lighthouse-mcp.com/mcp/sec"

Quick check

curl https://services.lighthouse-mcp.com/mcp

Returns a JSON directory of services and their per-service endpoints.