Skip to main content

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)

Source distribution for debtstack-ai 0.1.5
File Size Uploaded
debtstack_ai-0.1.5.tar.gz 22.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for debtstack-ai 0.1.5
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page