Metadata-Version: 2.4
Name: bosco-labs-data-mcp
Version: 0.2.1
Summary: MCP server: free LEI and SEC company lookups, plus SEC insider trades and filings, US House trades, DoD contracts, EU tenders and European company financials via Apify.
License-Expression: MIT
Project-URL: Homepage, https://boscolabs.dev
Project-URL: Repository, https://github.com/PB7-debug/bosco-labs-data
Keywords: mcp,apify,sec,edgar,insider-trading,tenders,financials,lei,gleif
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<3,>=2.3
Requires-Dist: httpx>=0.27
Dynamic: license-file

<!-- mcp-name: io.github.PB7-debug/bosco-labs-data -->

# Bosco Labs data: MCP server

One MCP server that gives AI agents official-source data: free company lookups (LEI, SEC),
plus SEC insider trades and filings, US House members' stock trades, Pentagon contract awards,
EU public tenders and the financials of European companies. The paid tools each run one of the
[Bosco Labs Apify Actors](https://apify.com/Bosco_labs) with **your own** Apify token. Every
tool returns a short JSON list with a source link on every row.

## Free tools (no token)

These two tools call the open official APIs directly: no Apify token, no key, no cost.

| Tool | Data (source) | Example question |
|---|---|---|
| `lei_lookup` | LEI, legal name, status, jurisdiction, registration number and ultimate parent of any legal entity (GLEIF, CC0 open data) | "What is Heineken N.V.'s LEI and is it active?" |
| `sec_company_lookup` | CIK, official name, tickers, exchanges, SIC industry and state of incorporation of SEC-registered companies (SEC EDGAR) | "What is Alphabet's CIK and on which exchange does it trade?" |

```bash
claude mcp add bosco-labs-data -- uvx bosco-labs-data-mcp   # no token needed for these
# ask: "Look up the LEI of ASML" -> lei_lookup {"query": "ASML"}
```

Each result has a `next_step` field naming the paid tool below that gives the full picture
(filings, insider trades or financials).

## Paid tools

| Tool | Data (source) | Price per row | Example question |
|---|---|---|---|
| `eu_annual_report_financials` | Audited financials of EU/UK listed companies (ESEF reports, filings.xbrl.org) | $0.05 + $0.01 per call | "Compare ASML's and Heineken's latest revenue and operating margin." |
| `european_company_accounts` | Accounts of UK, Danish and Norwegian companies, incl. private (Companies House, Erhvervsstyrelsen, Brønnøysund) | $0.04 | "What were the revenue and equity of Danish company CVR 24256790 in recent years?" |
| `sec_insider_trades` | Form 4 insider purchases and sales since 2006, cluster buys and sells (SEC EDGAR) | $0.0018 | "Have NVIDIA insiders bought or sold shares in the last month?" |
| `sec_filings` | Any EDGAR filing since 1994: 8-K items, 10-K, 10-Q, earnings release times (SEC EDGAR) | $0.001 | "When did Apple last release earnings, and was it after the close?" |
| `us_house_stock_trades` | STOCK Act trades of House members since 2014 (Clerk of the House) | $0.0018 | "What stocks did Nancy Pelosi trade this year?" |
| `eu_public_tenders` | EU/EEA public tenders and contract awards (TED) | $0.002 | "Find open IT-services tenders in Germany and the Netherlands from this week." |
| `dod_contract_awards` | DoD (or any federal agency) contract awards since FY2008, with winner tickers (USAspending.gov) | $0.005 | "Which Pentagon contracts did Kratos win this year?" |

Every tool has a `max_results` parameter with a small default (3 to 25 rows) and a hard
maximum, so one call costs cents. `dod_contract_awards` can take a minute or more.

Two other Bosco Labs Actors are not tools here because they work on your own Apify datasets or
Google credentials: [Dedup & Merge Datasets](https://apify.com/Bosco_labs/dataset-dedup) and
[Google Sheets Export](https://apify.com/Bosco_labs/sheets-export). Use them on Apify directly.

## Pricing

The free tools cost nothing. For the paid tools you pay Apify per row returned, with your own
token, at the prices above (the free Apify plan includes monthly credit). The server itself is
free; it only calls Apify (paid tools), GLEIF and the SEC (free tools).

## Install

1. For the paid tools, get an Apify API token:
   https://console.apify.com/settings/integrations (skip this for the free tools only).
2. Install [uv](https://docs.astral.sh/uv/).
3. Add the server to your client (below). Once the package is on PyPI the command is
   `uvx bosco-labs-data-mcp`. Until then, run it from this folder:
   `uvx --from /path/to/bosco-labs-data/mcp bosco-labs-data-mcp`.

### Claude Desktop

`claude_desktop_config.json` (Settings -> Developer -> Edit Config):

```json
{
  "mcpServers": {
    "bosco-labs-data": {
      "command": "uvx",
      "args": ["bosco-labs-data-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project): the same `mcpServers` block as
above.

### Claude Code

```bash
claude mcp add bosco-labs-data -e APIFY_TOKEN=apify_api_... -- uvx bosco-labs-data-mcp
```

Without a token, leave out the `env` block (or `-e APIFY_TOKEN=...`): the free tools work and
the paid tools reply that a token is needed.

## Alternative: Apify's hosted MCP server

Without installing anything, you can use the same Actors through Apify's own MCP server
(OAuth or your token; each Actor becomes a tool with its full input):

```
https://mcp.apify.com?tools=Bosco_labs/esef-annual-reports,Bosco_labs/company-accounts,Bosco_labs/sec-insider-trades,Bosco_labs/sec-filings-feed,Bosco_labs/us-house-trades,Bosco_labs/eu-tenders,Bosco_labs/dod-contract-awards
```

This server is the lighter option: typed parameters, small defaults and compact results.

## Development

```bash
uv run --with pytest pytest -q    # from this folder; Apify, GLEIF and SEC are mocked, plus a stdio smoke test
```

Source and releases: https://github.com/PB7-debug/bosco-labs-data (folder `mcp/`). Releases are
published to PyPI and the official MCP Registry by the `publish-mcp.yml` GitHub Actions
workflow; see
[PUBLISHING.md](https://github.com/PB7-debug/bosco-labs-data/blob/main/mcp/PUBLISHING.md).
