> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.defdex.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.defdex.io/_mcp/server.

# SDKs and CLI

Use REST directly, the JavaScript/TypeScript SDK, the Python SDK, the CLI or the data
MCP. Every interface reads the same published datasets and shares account request limits.
Organizations, agencies and programs use the generic collection methods in all clients.

## Install version 0.1.1

```sh
# CLI (Node.js 22+)
npm install --global https://app.defdex.io/downloads/v0.1.1/defdex-cli-0.1.1.tgz

# JavaScript / TypeScript (Node.js 22+)
npm install https://app.defdex.io/downloads/v0.1.1/defdex-sdk-0.1.1.tgz

# Python 3.10+
pip install https://app.defdex.io/downloads/v0.1.1/defdex-0.1.1.zip
```

These are direct public downloads. They do not require repository access and are not
npm/PyPI registry publication claims. Use the [manifest and SHA-256 checksums](https://app.defdex.io/downloads/v0.1.1/manifest.json)
to verify downloads. Versioned archives and their bundled contracts are immutable;
the [live reference](/api-reference/catalog-and-generic-access/list-datasets) documents
current service behavior. Older 0.1.0 downloads remain available; Python users should
use 0.1.1 for the production request-identifier fix.

## Choose your client

| Interface               | Guide                             | Read agencies                                                                    |
| ----------------------- | --------------------------------- | -------------------------------------------------------------------------------- |
| JavaScript / TypeScript | [JavaScript SDK](/javascript-sdk) | `api.list('organizations', {filters: {type: 'agency'}})`                         |
| Python                  | [Python SDK](/python-sdk)         | `api.list('organizations', filters={'type': 'agency'})`                          |
| Terminal                | [CLI](/cli)                       | `defdex list organizations --filters '{"type":"agency"}'`                        |
| AI tools                | [Data MCP](/data-mcp)             | `search_records` with `dataset: "organizations"` and `filters: {type: "agency"}` |

Set `DEFDEX_API_KEY` privately. The SDKs accept an explicit key in their constructor
for secret-manager integration; the CLI intentionally does not accept a key argument.
All clients default to `https://app.defdex.io/api/v1`, require HTTPS for remote
base-URL overrides, and do not follow redirects or automatically retry.

The SDKs support catalog, generic list/detail, award convenience list/detail, usage,
and correction submit/list/detail operations. There is no special `agencies()` method;
use the documented collection/filter pattern.