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 currency conversion (Frankfurter v2).

https://lighthouse.mentriva.dev/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://lighthouse.mentriva.dev/mcp/locations

Weather weather

Weather forecasts, current conditions, and ERA5 historical reanalysis at any location. Backed by the hosted Open-Meteo API.

https://lighthouse.mentriva.dev/mcp/weather

Coffee demand coffee-demand

Trader-shaped read view over Lighthouse coffee-demand sources: EU Comext import flows, Destatis Kaffeesteuer consumption proxy (when populated), and SEC EDGAR roaster operating metrics for the curated coffee universe (SBUX, KDP, LKNCY, SJM, QSR, BROS).

https://lighthouse.mentriva.dev/mcp/coffee-demand

Coffee supply coffee-supply

Trader-shaped read view over Lighthouse coffee-supply data: USDA PSD production & exports (every origin, with publish vintage) and IBGE SIDRA monthly Brazilian production. Flow-side sibling to Coffee demand. v1 rides data already ingested — origin export/auction sources (Cecafé, Conab, FNC) are the next layer.

https://lighthouse.mentriva.dev/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://lighthouse.mentriva.dev/mcp/coffee-stocks

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://lighthouse.mentriva.dev/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://lighthouse.mentriva.dev/mcp"
    }
  }
}

Per service — N servers, bare tool names

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

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

Unified

{
  "mcpServers": {
    "lighthouse": {
      "type": "http",
      "url": "https://lighthouse.mentriva.dev/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://lighthouse.mentriva.dev/mcp"

Per service

[mcp_servers.lighthouse-fx]
url = "https://lighthouse.mentriva.dev/mcp/fx"

[mcp_servers.lighthouse-locations]
url = "https://lighthouse.mentriva.dev/mcp/locations"

[mcp_servers.lighthouse-weather]
url = "https://lighthouse.mentriva.dev/mcp/weather"

[mcp_servers.lighthouse-coffee-demand]
url = "https://lighthouse.mentriva.dev/mcp/coffee-demand"

[mcp_servers.lighthouse-coffee-supply]
url = "https://lighthouse.mentriva.dev/mcp/coffee-supply"

[mcp_servers.lighthouse-coffee-stocks]
url = "https://lighthouse.mentriva.dev/mcp/coffee-stocks"

[mcp_servers.lighthouse-sec]
url = "https://lighthouse.mentriva.dev/mcp/sec"

Quick check

curl https://lighthouse.mentriva.dev/mcp

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