Skip to content

README.md

Latest commit

 

History

History
101 lines (74 loc) · 2.43 KB

README.md

File metadata and controls

101 lines (74 loc) · 2.43 KB

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
search_ratings Search credit ratings from S&P, Moody's, and Fitch
get_cds_spreads Get CDS spread time series (bond spread-to-treasury proxy)
get_changes See what changed in a company's debt structure since a date

Links

License

Apache-2.0