foundation.finance/finance-foundation

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Open financial reference data: companies with LEI/ISIN/FIGI, markets, funds, graph, live series.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "finance-foundation": {
      "url": "https://finance.foundation/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• lookup

  Get one financial entity by type and id (slug). Returns the full structured record including external identifiers (LEI/ISIN/FIGI) for companies. Data is seed-0.7 · marketcap-1 · 2026-08-30 — approximate reference values from public sources, versioned, NOT real-time (live_data series refresh every 3 hours). License CC BY 4.0. Correct uses: entity resolution, classification, relationships, jurisdiction/venue context. For live quotes or legal text go to the primary sources each entity links.

  Parameters:

  • entity_type (required) — string
  • id (required) — string — Entity slug, e.g. 'apple', 'nasdaq', 'bitcoin', 'united-states'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list

  List entities of one type, optionally filtered. Companies filter by sector/country/q; assets by type (Crypto|Index|Bond|Currency|Commodity). Returns up to `limit` records (default 25).

  Parameters:

  • entity_type (required) — string
  • q — string — Substring filter across all fields
  • type — string
  • limit — integer
  • sector — string
  • country — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search

  Free-text search across all entity types (companies, markets, assets, funds, banks, countries, research). Returns grouped matches with links.

  Parameters:

  • query (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• resolve_identifier

  Resolve a ticker, LEI, ISIN, FIGI, MIC code or name to entities. The entity-resolution tool: 'US0378331005' → Apple with all identifiers. Matches are ranked (exact identifier > ticker > name).

  Parameters:

  • query (required) — string — e.g. 'AAPL', 'HWUPKR0MPOU8FGXBT394', 'US0378331005', 'BBG001S5N8V8', 'XNAS'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• graph

  Knowledge-graph neighborhood of an entity: nodes and typed edges (lists_on, domiciled_in, managed_by, sector_peer…). Use to traverse from a company to its exchange, jurisdiction, funds and peers.

  Parameters:

  • entity_type (required) — string
  • id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ingest_text

  Extract financial entities and relationships from unstructured text into Finance Foundation Schema v0.1 JSON (companies, markets, assets, funds, banks, countries, indicators + typed relationships + unresolved_identifiers). LLM-powered, validated (taxonomy, ISIN checksums, LEI/MIC formats). Read-only transform: output goes to the caller only and is NEVER added to the Finance Foundation dataset. Limit 6000 chars.

  Parameters:

  • text (required) — string — Unstructured financial text (article, filing excerpt, notes), ≤6000 chars

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• live_data

  Latest reference values (refreshed every 3 hours): crypto (BTC/ETH/SOL/XRP/BNB/ADA/USDT/USDC/DAI), FX (EUR/USD, USD/JPY, GBP/USD, USD/CNY, USD/CHF, AUD/USD, USD/CAD, USD/INR, USD/BRL), ECB main refinancing rate, US 10Y Treasury yield, US CPI YoY. Each carries its source and observation date — NOT real-time ticks.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.