Bosco Labs Data
OfficialRead-only MCP server giving AI agents official-source company, financial, trading and procurement data (with a citation link on every row) — 2 free tools plus 7 pay-per-row tools.
Identify legal entities worldwide — look up an LEI or company name in GLEIF: legal name, status, jurisdiction, local registration number, ultimate parent (free, no key).
Turn a ticker/name into a CIK — SEC EDGAR company lookup: official name, tickers, exchanges, SIC industry, state of incorporation (free, no key).
Get audited European financials — ESEF annual reports for EU/EEA/UK listed companies: revenue, profit, EPS, balance sheet, cash flow, margins, growth, prior-year comparatives ($0.05/report).
Get private company accounts — UK (Companies House), Danish (CVR) and Norwegian (org nr) filings, including private firms: revenue, equity, employees, source registry links ($0.04/company-year).
Track insider trading — SEC Form 4 purchases/sales since 2006, filterable by ticker, CIK, role, value, transaction code, or cluster buys/sells ($0.0018/row).
Search SEC filings — any EDGAR form since 1994 (8-K item codes, 10-K, 10-Q, S-1, 13D, earnings releases) with document links and market timing ($0.001/row).
Follow US House stock trades — STOCK Act disclosures since 2014 by member, ticker, amount or date ($0.0018/row; Senate not covered).
Find EU public tenders — TED notices: open calls, contract awards with winners and values, deadlines, CPV sectors, buyer countries ($0.002/row).
Look up Pentagon/federal contract awards — USAspending/FPDS awards since FY2008 by recipient, ticker, agency, NAICS/PSC, with obligated amounts ($0.005/row).
Operate cheaply and safely — every tool has a capped
max_results, nothing is written or stored, and each result carries asource_url/filing_urlto cite.
Note: the schema lists the pre-0.4.0 tool names (e.g. lei_lookup, sec_filings); per the README they are now get_lei_record, search_sec_filings, etc., with unchanged inputs/outputs.
Provides tools for querying EU/EEA public procurement notices from TED (Tenders Electronic Daily), including open calls for tenders, contract awards, buyer countries, CPV sectors, deadlines, winners, and estimated or awarded values.
Bosco Labs data: MCP server
This repository is the source of a stdio MCP server, written in Python on the official
MCP Python SDK. The whole implementation
is bosco_mcp.py: 9 read-only tools that give AI agents official-source data,
with a source link on every row. It runs on your machine.
2 free tools call the open official APIs directly (GLEIF and SEC EDGAR): no token, no key.
7 paid tools call the Bosco Labs HTTP API with your Bosco Labs key (
BOSCO_API_KEY) and return a compact, typed result. You pay per row returned, from prepaid credits. A new key comes with $5.00 of free credit, no card: https://boscolabs.dev/api.html#keyAlready have an Apify account? Set
APIFY_TOKENinstead: the same tools then run as public Bosco Labs Apify Actors, billed to your Apify account.
Published on PyPI as bosco-labs-data-mcp and
in the official MCP Registry as io.github.Bosco-Labs/bosco-labs-data. MIT licensed.
Tools
Tool | Data (source) | Cost |
| LEI, legal name, status, jurisdiction, registration number and ultimate parent of any legal entity (GLEIF, CC0) | free |
| CIK, official name, tickers, exchanges, SIC industry, state of incorporation (SEC EDGAR) | free |
| Audited financials of EU/UK listed companies (ESEF reports, filings.xbrl.org) | $0.05 per row (on Apify + $0.01 per call) |
| Accounts of UK, Danish and Norwegian companies, incl. private ones (Companies House, Erhvervsstyrelsen, Brønnøysund) | $0.04 per row |
| Form 4 insider purchases and sales since 2006, cluster buys and sells (SEC EDGAR) | $0.0018 per row |
| Any EDGAR filing since 1994: 8-K items, 10-K, 10-Q, earnings release times (SEC EDGAR) | $0.001 per row |
| STOCK Act trades of House members since 2014 (Clerk of the House) | $0.0018 per row |
| EU/EEA public tenders and contract awards (TED) | $0.002 per row |
| DoD (or any federal agency) contract awards since FY2008, with winner tickers (USAspending.gov) | $0.005 per row |
Every tool has a max_results parameter with a small default and a hard maximum, so one call
costs cents. Results of the free tools include next_steps: the paid call that gives the full
picture. Without a key the paid tools answer where to get one; the free tools still work.
Related MCP server: us-gov-data-mcp
Changes in 0.4.0
All tools were renamed to one verb_noun scheme, the scheme the Bosco Labs remote MCP server (https://api.boscolabs.dev/mcp) uses too. Inputs and outputs did not change. Scripts or configs that call a tool by its old name must use the new one; the old names no longer exist.
Before 0.4.0 | From 0.4.0 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
How it works
get_lei_recordandfind_sec_companyqueryapi.gleif.organdsec.gov/data.sec.govwith a declared User-Agent, one retry on 429/5xx, and the SEC fair-access limit in mind.With
BOSCO_API_KEY, the paid toolsPOST api.boscolabs.dev/v1/<tool>with the input built from the tool's typed parameters, then keep only the fields an agent needs. With onlyAPIFY_TOKEN, they callapi.apify.com/v2/acts/<actor>/run-sync-get-dataset-itemswith the same input. If both are set,BOSCO_API_KEYis used.No state, no database, no telemetry. The only network hosts are
api.gleif.org,www.sec.gov,data.sec.gov,api.boscolabs.devandapi.apify.com.
Run it
With uv, from PyPI:
claude mcp add bosco-labs-data -e BOSCO_API_KEY=bl_live_... -- uvx bosco-labs-data-mcpFrom this source:
git clone https://github.com/Bosco-Labs/bosco-labs-data-mcp
cd bosco-labs-data-mcp
uv run bosco-labs-data-mcp # stdio; set BOSCO_API_KEY for the paid toolsOr with Docker: docker build -t bosco-labs-data-mcp . && docker run -i --rm -e BOSCO_API_KEY bosco-labs-data-mcp.
Claude Desktop or Cursor (claude_desktop_config.json, ~/.cursor/mcp.json):
{
"mcpServers": {
"bosco-labs-data": {
"command": "uvx",
"args": ["bosco-labs-data-mcp"],
"env": { "BOSCO_API_KEY": "bl_live_..." }
}
}
}Get a key ($5.00 free credit, no card) at https://boscolabs.dev/api.html#key; it is not needed
for the free tools. Apify users can put "APIFY_TOKEN": "apify_api_..." there instead
(https://console.apify.com/settings/integrations).
Tests
uv run --with pytest pytest -q # the APIs are mocked, plus a stdio smoke testRelated
The same key also works on the Bosco Labs remote MCP server (https://api.boscolabs.dev/mcp),
which has more tools (company registers, counterparty checks, sanctions screening, EU law and
more): https://boscolabs.dev. That server is not part of this repository.
Available Tools
9 toolsfind_sec_companySEC company lookup: ticker to CIK (free)ARead-only
Free, no API token needed. Identify a US-listed (SEC-registered) company: CIK, official name, ticker(s), exchange(s), industry (SIC code) and state of incorporation (source: SEC EDGAR company tickers file and submissions API). Use it to turn a ticker or name into the CIK that SEC tools take, or to check which exchange a stock trades on.
Pass a ticker, a CIK or part of the name (best matches first, then by company size; check
`name`). A name search covers companies with a listed ticker (about 10,000); a CIK also
finds filers without one.
Returns one row per company: cik, name, tickers, exchanges, sic, sic_description,
state_of_incorporation, fiscal_year_end (MMDD), source_url (the EDGAR company page; cite
it) and next_steps (the paid Bosco Labs calls for its filings and insider trades).
Inputs: query (required), max_results. Returns: result
get_company_accountsUK, Danish and Norwegian company accountsARead-only
Financials of UK, Danish and Norwegian companies, including private ones, from the accounts they file with Companies House (UK), Erhvervsstyrelsen (DK) and the Brønnøysund Register of Company Accounts (NO). Use it for revenue, profit, equity, cash or employees of a (private) company in these countries when you know its registration number.
Coverage: UK every year filed digitally (iXBRL; paper/PDF-only years are skipped, and small
UK companies often file no profit and loss account); Denmark all years; Norway the last 3
fiscal years (own accounts, not group).
Pass at least one registration number. Newest fiscal year first.
Returns one row per company per fiscal year: company_name, country, the registration
number, lei, period_end, currency, revenue, gross_profit, operating_profit,
profit_before_tax, net_income, total_assets, current_assets, cash_and_equivalents,
total_equity, net_assets, total_liabilities, employees, metrics_found and the source links
(report_url, registry_url, source_url). A missing figure was not filed; never treat it as
zero.
Cost to the user: $0.04 per company-year returned.
Inputs: max_results, dk_cvr_numbers, no_org_numbers, uk_company_numbers. Returns: result
get_eu_annual_reportsEU annual report financials (ESEF)ARead-only
Audited annual financials of European listed companies, from their official ESEF annual reports (source: filings.xbrl.org; EU/EEA, UK and Ukraine, about 27,600 reports from 28 countries; Germany is not covered). Use it for revenue, profit, margins, EPS, balance sheet, cash flow or dividends of a listed European company.
Pass exactly one of `lei` (most precise) or `company` (case-insensitive part of the
registered name; it can match several companies, so check `company_name`). `countries`
narrows a name search. Newest fiscal year first.
Returns one row per annual report: lei, company_name, country, period_end, currency,
revenue, gross_profit, operating_profit, ebitda, net_income, eps_basic/diluted,
total_assets, total_equity, total_liabilities, cash_and_equivalents, operating_cash_flow,
dividend_per_share, operating_margin, net_margin, return_on_equity, equity_ratio,
revenue_growth, prior_year (same metrics for the comparative year) and viewer_url (cite
it: the report page where every value can be checked). Money is in full units of
`currency`; ratios are decimals (0.25 = 25%). A missing metric was not tagged in the
report; never treat it as zero.
Cost to the user: $0.05 per annual report (with APIFY_TOKEN plus $0.01 per call). Takes
about 10-60 s.
Inputs: lei, company, countries, max_results. Returns: result
get_lei_recordLEI lookup (GLEIF, free)ARead-only
Free, no API token needed. Legal Entity Identifier (LEI) lookup in the official GLEIF register: about 2.9 million companies, funds and other legal entities worldwide (source: GLEIF API, CC0 open data). Use it to identify a company: its exact legal name, LEI, whether it is active, its jurisdiction and country, its local registration number and its ultimate parent company.
Pass an LEI (exact record) or a company name (best matches first; check `legal_name`).
Returns one row per entity: lei, legal_name, entity_status (ACTIVE/INACTIVE),
registration_status (ISSUED, LAPSED, ...), jurisdiction, legal_address_country,
legal_address_city, headquarters_country, registered_as (local registry number),
ultimate_parent (lei, legal_name; when reported), source_url (the GLEIF record; cite it)
and next_steps (the paid Bosco Labs call for this company's financials: tool and
arguments on the remote MCP server and HTTP API, stdio_tool in this package).
Inputs: query (required), max_results. Returns: result
search_dod_contract_awardsPentagon (DoD) contract awardsARead-only
US Department of Defense contract awards (or any other federal agency's) since FY2008: who won, how much was obligated, which service, the parent company and the winner's US stock ticker with SEC shares outstanding (source: USAspending.gov / FPDS, tickers from the SEC). Use it for "which contracts did Lockheed/Kratos win", the largest recent Pentagon awards, or awards in an industry (NAICS/PSC).
Default: DoD award-days of at least $7.5M (the DoD's public announcement threshold),
signed in the last 135 days. DoD data is published with a delay of up to ~3 months, so
the most recent weeks are incomplete. Newest signing dates first, then largest amounts.
Slow: a call can take a minute or more, so keep max_results small.
Returns one row per award per signing day: action_date, recipient_name, parent_name,
ticker, amount_usd (summed obligations that day), new_award, awarding_agency,
awarding_sub_agency, award_id, naics_description, psc_description, description
(shortened), shares_outstanding and usaspending_url (the award page; cite it).
Cost to the user: $0.005 per award row returned.
Inputs: date_to, tickers, agencies, date_from, +5 more. Returns: result
search_eu_tendersEU public tenders (TED)ARead-only
European public procurement notices from TED (Tenders Electronic Daily), the EU's official procurement journal: every above-threshold public contract in the EU/EEA, Switzerland and more, about 22,000 notices a week (source: official TED Search API). Use it to find open calls for tenders (with deadline and estimated value), contract awards (winners and awarded value) or planned purchases, by keyword, buyer country or sector.
Default: open calls for tenders published in the last 7 days. Newest first.
Returns one row per notice: notice_id, published, notice_type, title, description
(shortened), buyer_name, buyer_country, main_cpv, estimated_value, awarded_value,
currency, winner_names, deadline, procedure_type and ted_url (the notice; cite it).
Cost to the user: $0.002 per notice returned.
Inputs: keywords, countries, cpv_codes, max_results, +4 more. Returns: result
search_sec_filingsSEC EDGAR filings feedARead-only
SEC EDGAR filings of US-listed companies and other filers: any form (8-K, 10-K, 10-Q, S-1, 13D/13G, Form 4, DEF 14A, 20-F, ...), from filings accepted minutes ago back to 1994 (source: SEC EDGAR submissions API, indexes and live feed). Use it to find a company's latest reports, earnings release dates and times, officer changes or other 8-K events, or market-wide filings of one type.
Filter by tickers or CIKs (omit both for the whole market), form types, 8-K item codes or
earnings releases only. Filing date range: date_from/date_to, or the last `lookback_days`
days. Newest first.
Returns one row per filing: filing_date, accepted_at, market_timing (before_open,
market_hours, after_close), form, ticker, company_name, cik, items (8-K item codes),
item_descriptions, report_date and links: primary_document_url (the document; cite it),
filing_index_url.
Cost to the user: $0.001 per filing returned.
Inputs: ciks, date_to, tickers, date_from, +5 more. Returns: result
search_sec_insider_tradesSEC insider trades (Form 4)ARead-only
US insider trades reported to the SEC on Form 4 (officers, directors, 10% owners), from today's filings back to 2006 (source: SEC EDGAR Form 4 XML and the SEC insider data sets). Use it for "who is buying/selling stock X", insider activity before an event, or market-wide insider buying (cluster buys).
Filter by tickers or CIKs (omit both for the whole market; a whole-market scan of many
days can take a minute or more, so prefer tickers). Filing date range: date_from/date_to,
or the last `lookback_days` days. Newest first.
Returns one row per transaction: filing_date, ticker, issuer_name, insider_name,
insider_roles, officer_title, transaction_date, transaction_code (P buy, S sell, ...),
shares, price, value_usd, shares_owned_after, plan_10b5_1 (pre-planned sale; unknown
before 2023-04), usable_from (first day a backtest may act on the row),
in_cluster and filing_url (the SEC filing; cite it).
Cost to the user: $0.0018 per transaction returned.
Inputs: ciks, cluster, date_to, tickers, +6 more. Returns: result
search_us_house_stock_tradesUS House stock tradesARead-only
Stock, option, fund and bond trades disclosed by members of the US House of Representatives under the STOCK Act (Periodic Transaction Reports), from January 2014 to today (source: official filings of the Clerk of the House). Use it for "what did Representative X trade", "which House members traded NVDA", or recent congressional trades.
Filter by member name, tickers, transaction type and filing date (default: the last 30
days); use `years` for older history. Newest filings first.
Returns one row per trade: member_name, state_district, filing_date, transaction_date,
days_to_disclose, owner (self, spouse, joint, child), ticker, asset_description,
asset_type, transaction_type, amount_min/amount_max (USD range as filed), amount_text,
is_amendment and pdf_url (the filing; cite it). Amounts are ranges, not exact values.
The Senate is not covered.
Cost to the user: $0.0018 per trade returned.
Inputs: years, members, tickers, filed_to, +4 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct source/geography/entity type: GLEIF identification, SEC company lookup, EU ESEF reports, UK/DK/NO registry accounts, SEC filings, SEC insider trades, House trades, EU tenders, DoD awards. The only realistic confusion is between the two financial-statement tools (get_eu_annual_reports vs get_company_accounts), and the descriptions resolve it via geography and listed-vs-private coverage. Identification tools (get_lei_record name search vs find_sec_company name search) overlap slightly but clearly map to different registries.
Names consistently follow verb_noun with a source qualifier (get_/find_/search_ + sec/eu/us/dod + resource), making the pattern predictable. The get vs find vs search distinction is mostly meaningful (direct record vs identification vs filtered query), though get_lei_record also does fuzzy name search, which blurs the verb semantics a little.
Nine tools is well within the sweet spot, and each covers a distinct data source with no filler or near-duplicates. Nothing appears to be a thin wrapper that could be merged into another tool.
The surface covers company identification, EU/UK/DK/NO financials, SEC filings, insider trades, congressional trades, EU tenders and DoD awards, but conspicuously lacks US company financial statements (10-K/10-Q XBRL fundamentals), which is the natural next step after find_sec_company and is instead pushed to paid calls. Senate disclosures are also absent by design, leaving agent workflows that need US fundamentals or Senate trades at a dead end.
Maintenance
Related MCP Connectors
Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Read-only developer, date, finance, and text utilities. Authless remote MCP server by Clean.tools.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- AlicenseAqualityDmaintenanceMCP server for querying US federal contracts and public company financial data from USAspending and SEC EDGAR. Enables searching expiring contracts, screening companies by metrics, and retrieving financial histories.4MIT
- AlicenseAqualityBmaintenanceRead-only MCP server for official U.S. House stock disclosures, saved synthetic portfolio snapshots, and period changes with source and timing metadata. Requires an approved Capitol Ledger pilot API key; runs locally over stdio with no trade execution.3MIT
- AlicenseNot gradedqualityBmaintenanceStandalone Python 3.11 MCP stdio server exposing 31 read-only B2B regulatory compliance, KYB/AML sanctions, GLEIF LEI, US SEC EDGAR, openFDA, NHTSA, CISA KEV, ICANN RDAP, and Brazil fiscal audit tools.1MIT