Skip to main content
Glama
Bosco Labs Data

Bosco Labs Data

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
APIFY_TOKENNoOnly for Apify users, instead of BOSCO_API_KEY: your Apify API token. The paid tools then run as Bosco Labs Apify Actors, billed to your Apify account.
BOSCO_API_KEYNoYour Bosco Labs API key for the 7 paid tools: each row returned is paid from your prepaid credits. A new key has $5.00 free credit, no card: https://boscolabs.dev/api.html#key. Not needed for the 2 free tools (lei_lookup, sec_company_lookup).

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Official-source data (GLEIF, SEC EDGAR, US House Clerk, USAspending, EU TED, ESEF annual reports, UK/DK/NO company registers). get_lei_record and find_sec_company are free and need no key: use them first to identify a company. Every other tool is paid per row returned (from the user's Bosco Labs credits, or their Apify account), so request only as many rows as the question needs. Cite the source link of each row.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_lei_recordA

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

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

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

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

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

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

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

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

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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