Skip to main content
Glama
Bosco Labs Data

Bosco Labs Data

Official

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#key

  • Already have an Apify account? Set APIFY_TOKEN instead: 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

get_lei_record

LEI, legal name, status, jurisdiction, registration number and ultimate parent of any legal entity (GLEIF, CC0)

free

find_sec_company

CIK, official name, tickers, exchanges, SIC industry, state of incorporation (SEC EDGAR)

free

get_eu_annual_reports

Audited financials of EU/UK listed companies (ESEF reports, filings.xbrl.org)

$0.05 per row (on Apify + $0.01 per call)

get_company_accounts

Accounts of UK, Danish and Norwegian companies, incl. private ones (Companies House, Erhvervsstyrelsen, Brønnøysund)

$0.04 per row

search_sec_insider_trades

Form 4 insider purchases and sales since 2006, cluster buys and sells (SEC EDGAR)

$0.0018 per row

search_sec_filings

Any EDGAR filing since 1994: 8-K items, 10-K, 10-Q, earnings release times (SEC EDGAR)

$0.001 per row

search_us_house_stock_trades

STOCK Act trades of House members since 2014 (Clerk of the House)

$0.0018 per row

search_eu_tenders

EU/EEA public tenders and contract awards (TED)

$0.002 per row

search_dod_contract_awards

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

lei_lookup

get_lei_record

sec_company_lookup

find_sec_company

eu_annual_report_financials

get_eu_annual_reports

european_company_accounts

get_company_accounts

sec_insider_trades

search_sec_insider_trades

sec_filings

search_sec_filings

us_house_stock_trades

search_us_house_stock_trades

eu_public_tenders

search_eu_tenders

dod_contract_awards

search_dod_contract_awards

How it works

  • get_lei_record and find_sec_company query api.gleif.org and sec.gov / data.sec.gov with a declared User-Agent, one retry on 429/5xx, and the SEC fair-access limit in mind.

  • With BOSCO_API_KEY, the paid tools POST api.boscolabs.dev/v1/<tool> with the input built from the tool's typed parameters, then keep only the fields an agent needs. With only APIFY_TOKEN, they call api.apify.com/v2/acts/<actor>/run-sync-get-dataset-items with the same input. If both are set, BOSCO_API_KEY is used.

  • No state, no database, no telemetry. The only network hosts are api.gleif.org, www.sec.gov, data.sec.gov, api.boscolabs.dev and api.apify.com.

Run it

With uv, from PyPI:

claude mcp add bosco-labs-data -e BOSCO_API_KEY=bl_live_... -- uvx bosco-labs-data-mcp

From 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 tools

Or 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 test

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 tools
find_sec_companySEC company lookup: ticker to CIK (free)A
Read-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 accountsA
Read-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)A
Read-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)A
Read-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 awardsA
Read-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)A
Read-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 feedA
Read-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)A
Read-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 tradesA
Read-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

    A4.1/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      9
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Read-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.
      3
      MIT