MCP server for BasisData financial data API -- SEC EDGAR filings, company financials, and screening tools for 7,000+ US public companies
Project description
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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.1.3.tar.gz.
File metadata
- Download URL: basisdata_mcp-0.1.3.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ffc6b324af27d960794a152fb19192dcec93a6861d0e74f44ef17bc8dd6bca5d
|
|
| MD5 |
3a1662a126ac2bdda9eeb39a43999a05
|
|
| BLAKE2b-256 |
5c4c795419d40769e91eebaca8bb5dea55d8c81bf3ba512ae2dd2d6abb65dcfe
|
File details
Details for the file basisdata_mcp-0.1.3-py3-none-any.whl.
File metadata
- Download URL: basisdata_mcp-0.1.3-py3-none-any.whl
- Upload date:
- Size: 7.0 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 |
b1e66b488da4125708ac04a9db70d60e1fccc869a379b0beb9be3fc32198031e
|
|
| MD5 |
46dab295e0033bdbdf622b480eafcf44
|
|
| BLAKE2b-256 |
99003ed342afe2a74238a5adcdeecd48dbefa8b36f452ef89ffeb05190668586
|