Skip to main content

Corporate credit data API for AI agents

Project description

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

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

debtstack_ai-0.1.5.tar.gz (22.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

debtstack_ai-0.1.5-py3-none-any.whl (23.7 kB view details)

Uploaded Python 3

File details

Details for the file debtstack_ai-0.1.5.tar.gz.

File metadata

  • Download URL: debtstack_ai-0.1.5.tar.gz
  • Upload date:
  • Size: 22.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for debtstack_ai-0.1.5.tar.gz
Algorithm Hash digest
SHA256 f8d0bc3797bc8c89ca1daaeb0cf7fd4c9b84ca8a396b321e5c602aba7d226ca2
MD5 42ae340e8d6ca31d8bedcd25463509f9
BLAKE2b-256 bec3dbd232d1d6cf14b37a4c52f9a79b2b8a4cd5e128a1bded6c251444214042

See more details on using hashes here.

File details

Details for the file debtstack_ai-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: debtstack_ai-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 23.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for debtstack_ai-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 87d12bb80dd581dcb7b00b76381b217dc3d0d189fce33af27d60ca0787699563
MD5 4bc7934c2c4efc4b43eda52219b37222
BLAKE2b-256 5d5728603dd45c6cc40a5452804f71f7080c1aa11e77fcdfd391f964e5aa66a3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page