jerbouma avatar

Finance Database

jerbouma/financedatabase

Equities, ETFs, indices, currencies and cryptos, categorised.

GitHub stars
9.6K
tools
8
transport
STDIO, HTTP
last updated
Nov 14, 2026

Install

From registry metadata
$ npx add-mcp https://financedatabase.jeroenbouma.com/mcp --name financedatabase

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http financedatabase https://financedatabase.jeroenbouma.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 8 tools

Verified live against the running server on Nov 20, 2026.

equitiesList 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', '<fi...16 params

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', '<fi...

Parameters* required
countryvalue
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 cou...
currencyvalue
Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
exchangevalue
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' wi...
include_delistedboolean
Include delisted entries (excluded by default). Adds a `delisted` column.default: false
include_summaryboolean
Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.default: false
industryvalue
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.
industry_groupvalue
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.
limitinteger
Rows to return (default 25, maximum 200).default: 25
marketvalue
Full market name, e.g. 'NASDAQ Global Select' or 'Euronext Amsterdam'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
market_capvalue
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 li...
micvalue
ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
offsetinteger
Rows to skip, for paging (see the `_notes` hint in the response).default: 0
only_primary_listingboolean
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-listin...default: false
queryvalue
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.
sectorvalue
Sector, e.g. 'Information Technology', 'Health Care' or 'Financials'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
show_columnsvalue
Columns to return, comma-separated. Default: symbol, name, currency, sector, industry_group, industry, exchange, country, market_cap. Available: symbol, name, summary, currency, sector, industry_gr...
etfsList 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 v...13 params

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 v...

Parameters* required
categoryvalue
Category, e.g. 'Large Cap', 'Bonds', 'Technology' or 'Emerging Markets'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
category_groupvalue
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.
currencyvalue
Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
exchangevalue
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' wi...
familyvalue
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-insens...
include_delistedboolean
Include delisted entries (excluded by default). Adds a `delisted` column.default: false
include_summaryboolean
Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.default: false
limitinteger
Rows to return (default 25, maximum 200).default: 25
micvalue
ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
offsetinteger
Rows to skip, for paging (see the `_notes` hint in the response).default: 0
only_primary_listingboolean
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-listin...default: false
queryvalue
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.
show_columnsvalue
Columns to return, comma-separated. Default: symbol, name, currency, category_group, category, family, exchange. Available: symbol, name, currency, summary, category_group, category, family, exchan...
indicesList 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...10 params

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...

Parameters* required
categoryvalue
Category, e.g. 'Large Cap', 'Bonds', 'Technology' or 'Emerging Markets'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
category_groupvalue
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.
currencyvalue
Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
exchangevalue
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' wi...
include_summaryboolean
Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.default: false
limitinteger
Rows to return (default 25, maximum 200).default: 25
micvalue
ISO 10383 market identifier code, e.g. 'XNAS', 'XNYS' or 'XAMS'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
offsetinteger
Rows to skip, for paging (see the `_notes` hint in the response).default: 0
queryvalue
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.
show_columnsvalue
Columns to return, comma-separated. Default: symbol, name, currency, category_group, category, exchange. Available: symbol, name, currency, summary, category_group, category, exchange, mic.
currenciesList 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').7 params

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').

Parameters* required
base_currencyvalue
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.
include_summaryboolean
Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.default: false
limitinteger
Rows to return (default 25, maximum 200).default: 25
offsetinteger
Rows to skip, for paging (see the `_notes` hint in the response).default: 0
queryvalue
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.
quote_currencyvalue
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.
show_columnsvalue
Columns to return, comma-separated. Default: symbol, name, base_currency, quote_currency, exchange. Available: symbol, name, base_currency, quote_currency, summary, exchange.
cryptosList 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.7 params

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.

Parameters* required
cryptocurrencyvalue
Cryptocurrency code, e.g. 'ETH', 'ADA' or 'XRP'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
currencyvalue
Trading currency as an ISO code, e.g. 'USD' or 'EUR'. Several values: comma-separated (e.g. 'A, B') or a list. Case-insensitive.
include_summaryboolean
Add the business/fund description (truncated to 300 characters). Off by default to keep responses small.default: false
limitinteger
Rows to return (default 25, maximum 200).default: 25
offsetinteger
Rows to skip, for paging (see the `_notes` hint in the response).default: 0
queryvalue
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.
show_columnsvalue
Columns to return, comma-separated. Default: symbol, name, cryptocurrency, currency, exchange. Available: symbol, name, cryptocurrency, currency, summary, exchange, website.
search_categoriesList 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_opti...

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_opti...

No parameters. Call it with no arguments.

show_optionsShow 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' secto...5 params

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' secto...

Parameters* required
asset_class*string
The asset class: equities, etfs, indices, currencies or cryptos.
filtersvalue
Optional filters narrowing the options, e.g. {'country': 'Netherlands'} to list only the sectors present in the Netherlands. Values may be comma-separated.
include_delistedboolean
Include values only used by delisted entries (equities and ETFs).default: false
limitvalue
Maximum values to return (default 100, maximum 500); the total count is always given.
selectionvalue
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.
search_instrumentsFind 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 s...5 params

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 s...

Parameters* required
asset_classesvalue
Asset classes to search: 'all' (default) or one or more of equities, etfs, indices, currencies, cryptos (comma-separated).default: all
include_delistedboolean
Include delisted equities and ETFs.default: false
limitinteger
Rows to return (default 25, maximum 200).default: 25
offsetinteger
Rows to skip, for paging.default: 0
query*string
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.

Sponsors

Readme

Details

Repository
github.com/jerbouma/financedatabase
Package
financedatabase
Transport
STDIO, HTTP
Registry
MCP registry, active
Tools verified
Nov 20, 2026