Finance Database
Equities, ETFs, indices, currencies and cryptos, categorised.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"financedatabase": {
"command": "uvx",
"args": [
"financedatabase"
]
}
}
}Runnable packages
2.5.2stdioRemote endpoints
https://financedatabase.jeroenbouma.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟢equities(query, country, sector, industry_group, industry, ...)
List listed companies (stocks) matching filters such as country, sector, industry group, industry, exchange and market cap tier, or matching a free-text query on symbol or name. Every filter accepts one value or several comma-separated values. Use show_options('equities', '<field>') to see valid filter values. Returns categorisation (sector, industry, country, exchange, market cap tier), not prices.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional free-text search on symbol and name (case-insensitive substring, e.g. 'apple' or 'AAPL'); an ISIN also matches where available. Best matches come first.",
"title": "Query"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Country of the company's headquarters, e.g. 'United States' or 'Netherlands'. This is not where it trades: ASML (Netherlands) is also listed in New York and Frankfurt. To find the listings in a country, filter on exchange or currency. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Country"
},
"sector": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Sector, e.g. 'Information Technology', 'Health Care' or 'Financials'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Sector"
},
"industry_group": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Industry group, e.g. 'Semiconductors' or 'Banking'. Use show_options to find the exact names. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Industry Group"
},
"industry": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Industry, e.g. 'Biotechnology', 'Banks' or 'Hospitality & Leisure'. Use show_options to find the exact names. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Industry"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Currency"
},
"exchange": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exchange code, e.g. 'NMS' (NASDAQ Global Select), 'NYQ' (NYSE), 'PNK' (OTC Markets) or 'AMS' (Euronext Amsterdam). Use it to find an instrument's listings on certain exchanges, e.g. query='ASML' with exchange='NMS,NYQ,PNK' for its US listings. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Exchange"
},
"mic": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Mic"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Full market name, e.g. 'NASDAQ Global Select' or 'Euronext Amsterdam'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Market"
},
"market_cap": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Market cap tier: 'Mega Cap' (>= $200B), 'Large Cap' (>= $10B), 'Mid Cap' (>= $2B), 'Small Cap' (>= $300M), 'Micro Cap' (>= $50M) or 'Nano Cap'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Market Cap"
},
"include_delisted": {
"default": false,
"description": "Include delisted entries (excluded by default). Adds a `delisted` column.",
"title": "Include Delisted",
"type": "boolean"
},
"only_primary_listing": {
"default": false,
"description": "Only primary listings: per instrument its listing on the main exchange of its home market (ASML.AS for ASML), or without one its listing on the largest main exchange abroad. Leaves out cross-listings, over-the-counter lines and depositary receipts.",
"title": "Only Primary Listing",
"type": "boolean"
},
"show_columns": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Columns to return, comma-separated. Default: symbol, name, currency, sector, industry_group, industry, exchange, country, market_cap. Available: symbol, name, summary, currency, sector, industry_group, industry, exchange, mic, market, country, state, city, zipcode, website, market_cap, isin, cusip, figi, composite_figi, shareclass_figi, delisted.",
"title": "Show Columns"
},
"include_summary": {
"default": false,
"description": "Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.",
"title": "Include Summary",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging (see the `_notes` hint in the response).",
"title": "Offset",
"type": "integer"
}
},
"title": "equitiesArguments"
}🟢etfs(query, category_group, category, family, currency, ...)
List exchange-traded funds matching filters such as category group, category, family (issuer), currency and exchange, or matching a free-text query on symbol or name. Every filter accepts one value or several comma-separated values. Use show_options('etfs', '<field>') to see valid filter values.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional free-text search on symbol and name (case-insensitive substring, e.g. 'apple' or 'AAPL'); an ISIN also matches where available. Best matches come first.",
"title": "Query"
},
"category_group": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Broad category group, e.g. 'Equities', 'Fixed Income', 'Commodities' or 'Information Technology'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Category Group"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Category, e.g. 'Large Cap', 'Bonds', 'Technology' or 'Emerging Markets'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Category"
},
"family": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Fund family (issuer), e.g. 'BlackRock Asset Management' or 'Vanguard Asset Management'. Use show_options to find the exact name. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Family"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Currency"
},
"exchange": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exchange code, e.g. 'NMS' (NASDAQ Global Select), 'NYQ' (NYSE), 'PNK' (OTC Markets) or 'AMS' (Euronext Amsterdam). Use it to find an instrument's listings on certain exchanges, e.g. query='ASML' with exchange='NMS,NYQ,PNK' for its US listings. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Exchange"
},
"mic": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Mic"
},
"include_delisted": {
"default": false,
"description": "Include delisted entries (excluded by default). Adds a `delisted` column.",
"title": "Include Delisted",
"type": "boolean"
},
"only_primary_listing": {
"default": false,
"description": "Only primary listings: per instrument its listing on the main exchange of its home market (ASML.AS for ASML), or without one its listing on the largest main exchange abroad. Leaves out cross-listings, over-the-counter lines and depositary receipts.",
"title": "Only Primary Listing",
"type": "boolean"
},
"show_columns": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Columns to return, comma-separated. Default: symbol, name, currency, category_group, category, family, exchange. Available: symbol, name, currency, summary, category_group, category, family, exchange, mic, isin, delisted.",
"title": "Show Columns"
},
"include_summary": {
"default": false,
"description": "Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.",
"title": "Include Summary",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging (see the `_notes` hint in the response).",
"title": "Offset",
"type": "integer"
}
},
"title": "etfsArguments"
}🟢indices(query, category_group, category, currency, exchange, ...)
List market indices matching filters such as category group, category, currency and exchange, or matching a free-text query on symbol or name (e.g. query='S&P 500'). Every filter accepts one value or several comma-separated values. Use show_options('indices', '<field>') to see valid filter values.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional free-text search on symbol and name (case-insensitive substring, e.g. 'apple' or 'AAPL'); an ISIN also matches where available. Best matches come first.",
"title": "Query"
},
"category_group": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Broad category group, e.g. 'Equities', 'Fixed Income', 'Commodities' or 'Information Technology'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Category Group"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Category, e.g. 'Large Cap', 'Bonds', 'Technology' or 'Emerging Markets'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Category"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Currency"
},
"exchange": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Exchange code, e.g. 'NMS' (NASDAQ Global Select), 'NYQ' (NYSE), 'PNK' (OTC Markets) or 'AMS' (Euronext Amsterdam). Use it to find an instrument's listings on certain exchanges, e.g. query='ASML' with exchange='NMS,NYQ,PNK' for its US listings. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Exchange"
},
"mic": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Mic"
},
"show_columns": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Columns to return, comma-separated. Default: symbol, name, currency, category_group, category, exchange. Available: symbol, name, currency, summary, category_group, category, exchange, mic.",
"title": "Show Columns"
},
"include_summary": {
"default": false,
"description": "Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.",
"title": "Include Summary",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging (see the `_notes` hint in the response).",
"title": "Offset",
"type": "integer"
}
},
"title": "indicesArguments"
}🟢currencies(query, base_currency, quote_currency, show_columns, include_summary, ...)
List currency pairs matching a base currency and/or quote currency (ISO codes, comma-separated for several), or matching a free-text query on symbol or name (e.g. query='EURUSD').
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional free-text search on symbol and name (case-insensitive substring, e.g. 'apple' or 'AAPL'); an ISIN also matches where available. Best matches come first.",
"title": "Query"
},
"base_currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Base currency of the pair as an ISO code, e.g. 'EUR' in EURUSD. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Base Currency"
},
"quote_currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Quote currency of the pair as an ISO code, e.g. 'USD' in EURUSD. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Quote Currency"
},
"show_columns": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Columns to return, comma-separated. Default: symbol, name, base_currency, quote_currency, exchange. Available: symbol, name, base_currency, quote_currency, summary, exchange.",
"title": "Show Columns"
},
"include_summary": {
"default": false,
"description": "Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.",
"title": "Include Summary",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging (see the `_notes` hint in the response).",
"title": "Offset",
"type": "integer"
}
},
"title": "currenciesArguments"
}🟢cryptos(query, cryptocurrency, currency, show_columns, include_summary, ...)
List cryptocurrency pairs matching a cryptocurrency (e.g. 'ETH') and/or the currency it is quoted in (e.g. 'USD' or 'BTC'), or matching a free-text query on symbol or name. Every filter accepts one value or several comma-separated values.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional free-text search on symbol and name (case-insensitive substring, e.g. 'apple' or 'AAPL'); an ISIN also matches where available. Best matches come first.",
"title": "Query"
},
"cryptocurrency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Cryptocurrency code, e.g. 'ETH', 'ADA' or 'XRP'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Cryptocurrency"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.",
"title": "Currency"
},
"show_columns": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Columns to return, comma-separated. Default: symbol, name, cryptocurrency, currency, exchange. Available: symbol, name, cryptocurrency, currency, summary, exchange, website.",
"title": "Show Columns"
},
"include_summary": {
"default": false,
"description": "Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.",
"title": "Include Summary",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging (see the `_notes` hint in the response).",
"title": "Offset",
"type": "integer"
}
},
"title": "cryptosArguments"
}🟢search_categories
List the Finance Database's asset classes (which instruments exist and how they are classified, no prices), with their tool, size and filters. Use this first to see what is available. Each asset class has its own tool (e.g. `equities`) whose filters are listed here; `show_options` gives the valid values of each filter. Returns: str: Markdown table of asset classes.
Input Schema
{
"type": "object",
"properties": {},
"title": "search_categoriesArguments"
}🟢show_options(asset_class, selection, filters, include_delisted, limit)
Show the valid values of a Finance Database filter (e.g. every sector or country) for an asset class. Use this before filtering an asset class tool so the exact values are known. Filters narrow the options to what actually occurs, e.g. the industries of the 'Health Care' sector in Germany. Returns: str: Compact JSON with the values and their total count.
Input Schema
{
"type": "object",
"properties": {
"asset_class": {
"description": "The asset class: equities, etfs, indices, currencies or cryptos.",
"title": "Asset Class",
"type": "string"
},
"selection": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The filter to list the values of, e.g. 'sector', 'country', 'industry' (equities) or 'category', 'family' (ETFs). Leave empty for an overview of every filter.",
"title": "Selection"
},
"filters": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional filters narrowing the options, e.g. {'country': 'Netherlands'} to list only the sectors present in the Netherlands. Values may be comma-separated.",
"title": "Filters"
},
"include_delisted": {
"default": false,
"description": "Include values only used by delisted entries (equities and ETFs).",
"title": "Include Delisted",
"type": "boolean"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum values to return (default 100, maximum 500); the total count is always given.",
"title": "Limit"
}
},
"required": [
"asset_class"
],
"title": "show_optionsArguments"
}🟢search_instruments(query, asset_classes, include_delisted, limit, offset)
Find which instruments exist in the Finance Database by ticker, name or ISIN, across equities, ETFs, indices, currencies and cryptocurrencies at once, with their symbol, exchange and classification (no prices or financial data). Matches are case-insensitive substrings of the symbol or name (plus exact ISIN/CUSIP/FIGI matches), ordered by relevance: exact symbol first, then symbols and names starting with the query, primary listings and larger companies first. Each row says which asset class tool has the full record. Returns: str: Compact JSON with the matches and their total count per asset class.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Ticker, (part of a) name or identifier to look up, e.g. 'AAPL', 'apple', 'S&P 500', 'bitcoin' or an ISIN such as 'US0378331005'. Case-insensitive.",
"title": "Query",
"type": "string"
},
"asset_classes": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
],
"default": "all",
"description": "Asset classes to search: 'all' (default) or one or more of equities, etfs, indices, currencies, cryptos (comma-separated).",
"title": "Asset Classes"
},
"include_delisted": {
"default": false,
"description": "Include delisted equities and ETFs.",
"title": "Include Delisted",
"type": "boolean"
},
"limit": {
"default": 25,
"description": "Rows to return (default 25, maximum 200).",
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip, for paging.",
"title": "Offset",
"type": "integer"
}
},
"required": [
"query"
],
"title": "search_instrumentsArguments"
}Community
Evidence