basisdata-mcp
MCP server for the BasisData financial data API. Gives AI agents (Claude Desktop, Cursor, Windsurf, etc.) access to SEC EDGAR data for 7,000+ US public companies.
Quick start
- Get a free API key at basisdata.dev
- Add to your MCP client config:
{
"mcpServers": {
"basisdata": {
"command": "uvx",
"args": ["basisdata-mcp"],
"env": {
"BASISDATA_API_KEY": "bd_live_..."
}
}
}
}
- Restart your MCP client. Ask: "Search for Apple using basisdata"
Tools
| Tool | Description |
|---|---|
search_companies |
Find companies by name, ticker, or CIK |
get_company |
Company metadata, SIC code, exchange, fiscal year |
get_financials |
Quarterly/annual income statement, balance sheet, cash flow |
get_annual_financials |
Multi-year annual financials for trend analysis |
get_ratios |
P/E, EV/EBITDA, margins, growth, leverage, FCF yield |
compare_companies |
Side-by-side comparison of 2-10 companies |
screen_companies |
Filter by revenue, margins, growth, leverage, exchange |
search_filings |
Full-text search across SEC filings (10-K, 10-Q, 8-K) |
get_filing |
Filing details and document URLs by accession number |
Data coverage
- 7,017 US public companies with tickers
- 4.8M SEC filings indexed
- 50+ computed metrics (valuation, profitability, growth, leverage)
- < 100ms API response time
REST API
The MCP server calls the BasisData REST API at api.basisdata.dev. You can also use the API directly:
curl -H "Authorization: Bearer bd_live_..." \
https://api.basisdata.dev/v1/companies?search=apple
Full docs: api.basisdata.dev/docs
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
basisdata_mcp-0.4.0.tar.gz
(7.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file basisdata_mcp-0.4.0.tar.gz.
File metadata
- Download URL: basisdata_mcp-0.4.0.tar.gz
- Upload date:
- Size: 7.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
abfd870bab2eb047234832f230e3e3b1956d8f461f7c877f0ced3ce2463aaa6b
|
|
| MD5 |
047c77df679aa9d9cdb001cd6d60e5f3
|
|
| BLAKE2b-256 |
c40745255e63e0c8d3c3b7afd32892cc884dc2115705f623e53e555d0830347c
|
File details
Details for the file basisdata_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: basisdata_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 9.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
494e7248c6f8da5aa12393efe0008046923bc5e3e49f114ef0a224ec6ba37520
|
|
| MD5 |
f53fbe0d772a8fb7fb7d279c4c5c774d
|
|
| BLAKE2b-256 |
1599b241febed89bb5eb58a229faac179e6677419da21474e20734b84fcaa508
|
