DebtStack.ai — Python SDK & MCP Server
Corporate credit data API for AI agents. Search bonds, leverage ratios, guarantor chains, covenants, and SEC filings across 300+ companies.
mcp-name: io.github.marcellusgreen/debtstack-ai
Installation
pip install debtstack-ai
For MCP server support:
pip install debtstack-ai[mcp]
Quick Start
from debtstack import DebtStack
client = DebtStack(api_key="ds_xxxxx")
# Search companies by leverage
companies = client.companies(min_leverage=4.0, sector="Technology")
# Search bonds by yield
bonds = client.bonds(min_ytm=8.0, seniority="senior_secured", has_pricing=True)
# Resolve a bond by description
matches = client.resolve_bond("RIG 8% 2027")
# Get corporate structure
structure = client.corporate_structure("CHTR")
MCP Server
Connect DebtStack to Claude Desktop, Claude Code, Cursor, and other MCP clients.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"debtstack-ai": {
"command": "debtstack-mcp",
"env": {
"DEBTSTACK_API_KEY": "ds_xxxxx"
}
}
}
}
Claude Code
Add to ~/.claude/mcp.json:
{
"mcpServers": {
"debtstack-ai": {
"command": "debtstack-mcp",
"env": {
"DEBTSTACK_API_KEY": "ds_xxxxx"
}
}
}
}
Available MCP Tools
| Tool | Description |
|---|---|
search_companies |
Search companies by ticker, sector, leverage ratio, and risk flags |
search_bonds |
Search bonds by ticker, seniority, yield, spread, and maturity |
resolve_bond |
Look up a bond by CUSIP, ISIN, or description |
get_guarantors |
Find all entities that guarantee a bond |
get_corporate_structure |
Get full parent-subsidiary hierarchy |
search_pricing |
Get FINRA TRACE bond prices, YTM, and spreads |
search_documents |
Search SEC filing sections |
get_changes |
See what changed in a company's debt structure since a date |
Links
License
Apache-2.0
Metadata
Release files for debtstack-ai 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| debtstack_ai-0.1.5.tar.gz | 22.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| debtstack_ai-0.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.2 kB
Release files / debtstack_ai-0.1.5.tar.gz
| Download URL | debtstack_ai-0.1.5.tar.gz |
|---|---|
| Size | 22.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f8d0bc3797bc8c89ca1daaeb0cf7fd4c9b84ca8a396b321e5c602aba7d226ca2
|
|
BLAKE2b-256 checksum How to use checksums |
bec3dbd232d1d6cf14b37a4c52f9a79b2b8a4cd5e128a1bded6c251444214042
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / debtstack_ai-0.1.5-py3-none-any.whl
| Download URL | debtstack_ai-0.1.5-py3-none-any.whl |
|---|---|
| Size | 23.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
87d12bb80dd581dcb7b00b76381b217dc3d0d189fce33af27d60ca0787699563
|
|
BLAKE2b-256 checksum How to use checksums |
5d5728603dd45c6cc40a5452804f71f7080c1aa11e77fcdfd391f964e5aa66a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|