# Dirigon API

> BDC Schedule of Investments: fund tapes, credits, and the marks each holder filed.

Human docs: https://dirigon.com/guide
OpenAPI: https://dirigon.com/v1/openapi.yaml
Fields: https://dirigon.com/v1/fields.json
MCP: POST https://dirigon.com/v1/mcp  (put the key on the connector, never in a chat)

Auth: header `X-API-KEY`. Get a key at https://dirigon.com/billing. You see the secret once. Trial, Tape, and Matched do not wait for approval. Meter is request units (most calls 1; issuer history 5; SOI tape 10). MCP uses the same units.

Fetch this file, then the page you need. Each page is one product surface.

## Docs

- [Introduction](https://dirigon.com/docs/introduction.md): Connect an agent to BDC Schedules of Investments.
- [Quick start](https://dirigon.com/docs/quickstart.md): Authenticate and make your first request.
- [Find a credit](https://dirigon.com/docs/find-a-credit.md): Search a borrower. Same idea as Find credit in the terminal.
- [Holder marks](https://dirigon.com/docs/holder-marks.md): Every fund that printed that name, and the mark they filed.
- [Fund profile](https://dirigon.com/docs/fund-profile.md): Ares, Blackstone, Blue Owl, and the rest, by CIK or ticker.
- [SOI tape](https://dirigon.com/docs/soi-tape.md): The fund's Schedule of Investments, line by line.
- [Non-accrual](https://dirigon.com/docs/non-accrual.md): Lines the fund footnoted as non-accrual.
- [Coverage](https://dirigon.com/docs/coverage.md): How many funds and credits are in the latest snapshot.
- [MCP](https://dirigon.com/docs/mcp.md): Same data, for Claude, ChatGPT, and other agents.
- [Pricing](https://dirigon.com/docs/pricing.md): Trial, Tape, Matched, Terminal. Get a key at /billing.
- [OpenAPI](https://dirigon.com/v1/openapi.yaml): Machine-readable spec.

## What you can access

- **Find a credit** `https://dirigon.com/v1/issuers?q=Coupa` then `/issuers/{issuer_id}/marks`
- **Most held** `https://dirigon.com/v1/issuers?sort=holders&limit=25`
- **Holder marks** `https://dirigon.com/v1/issuers/{issuer_id}/marks`
- **Fund profile** `https://dirigon.com/v1/filers?q=ARCC` then `/filers/{cik}` (includes software %)
- **SOI tape** `https://dirigon.com/v1/filers/{cik}/positions`
- **Software book** `https://dirigon.com/v1/software` (top credits and funds). `?cik=1287750` for one fund
- **Non-accrual** `https://dirigon.com/v1/non-accrual`
- **Universe** `https://dirigon.com/v1/coverage`

Marks are fair value / cost from the filed SOI. Money fields are $ millions. Identify funds by CIK. If `blocked` is true, skip that credit for comparisons.

## MCP tools

Do not paste the key into a chat. MCP: `https://dirigon.com/v1/mcp` with header `X-API-KEY` (Claude Code, Codex, Cursor, ChatGPT). Claude app can also sign in with the mailbox on the plan.

- `get_issuer` - Peeled credit. One hit: marks, family exposure, history. family_fv_m = total borrower exposure.
- `get_disagreement` - Holder marks, or the disagreement screen if you pass no id
- `get_filer` - Fund card (book, top credits, software membership vs printed mix)
- `get_positions` - SOI tape for one fund (cik required; n is the full tape)
- `get_non_accrual` - Non-accrual lines (optional cik or q)
- `get_coverage` - Snapshot size and which periods the funds are on
- `get_sector` - Sectors page (q=software|healthcare, view=credits|funds, or cik)
- `get_clo_tranche` - CLO note holders across CEFs, BDCs, and interval funds

## Quick start

Trial first call (issuer cards). Tape first call is `/v1/filers?q=ARCC`. A call outside the plan returns HTTP 402.

```
curl "https://dirigon.com/v1/issuers?q=Denali" -H "X-API-KEY: YOUR_KEY"
curl "https://dirigon.com/v1/filers?q=ARCC" -H "X-API-KEY: YOUR_KEY"
curl "https://dirigon.com/v1/filers/1287750/positions?limit=5" -H "X-API-KEY: YOUR_KEY"
```