> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs Overview

> Choose the right DevHelm SDK — TypeScript, Python, or MCP Server for AI agents

DevHelm provides typed SDKs for TypeScript and Python, plus an MCP server for AI agent integration. Choose based on your runtime and use case.

## SDKs

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/sdk/typescript/quickstart">
    Typed client for Node.js and browser environments. Full CRUD on all resources with auto-pagination.
  </Card>

  <Card title="Python SDK" icon="python" href="/sdk/python/quickstart">
    Sync and async clients for Python 3.11+. Pydantic models for type safety.
  </Card>
</CardGroup>

### Quick comparison

| Feature      | TypeScript                                     | Python                                             |
| ------------ | ---------------------------------------------- | -------------------------------------------------- |
| Package      | `@devhelm/sdk`                                 | `devhelm`                                          |
| Runtime      | Node.js 18+, browsers                          | Python 3.11+                                       |
| HTTP library | `openapi-fetch`                                | `httpx`                                            |
| Types        | OpenAPI-generated TypeScript                   | Pydantic models                                    |
| Async        | Native (Promise-based)                         | Sync only; use `asyncio.to_thread` for concurrency |
| Pagination   | `list()` auto-fetches, `listPage()` for manual | `list()` auto-fetches, `list_page()` for manual    |

Both SDKs provide the same resource coverage:

| Namespace                 | Operations                                                                     |
| ------------------------- | ------------------------------------------------------------------------------ |
| Monitors                  | list, get, create, update, delete, pause, resume, test, results, versions      |
| Incidents                 | list, get, create, resolve                                                     |
| Forensics                 | incident timeline, check trace, policy snapshot, rule evaluations, transitions |
| Alert channels            | list, get, create, update, delete, test                                        |
| Notification policies     | list, get, create, update, delete, test                                        |
| Tags                      | list, get, create, update, delete                                              |
| Environments              | list, get, create, update, delete                                              |
| Secrets                   | list, create, update, delete                                                   |
| Resource groups           | list, get, create, update, delete, add/remove members                          |
| Webhooks                  | list, get, create, update, delete, test                                        |
| API keys                  | list, create, revoke, delete                                                   |
| Dependencies              | list, get, track, update alert sensitivity, delete                             |
| Deploy lock               | acquire, current, release, force-release                                       |
| Maintenance windows       | list, get, create, update, cancel                                              |
| Services (status catalog) | search, get, live status, uptime, incidents, maintenances, categories, summary |
| Status                    | overview                                                                       |
| Status pages              | pages, components, groups, incidents, subscribers, custom domains              |

## MCP Server

The MCP server gives AI coding assistants (Cursor, Claude Desktop, Windsurf, Claude Code) direct access to your DevHelm account. Hosted at `mcp.devhelm.io` — connect with a single URL, no install required.

<CardGroup cols={2}>
  <Card title="MCP Server" icon="robot" href="/sdk/mcp/overview">
    Connect your AI assistant in 30 seconds.
  </Card>

  <Card title="Tools reference" icon="wrench" href="/sdk/mcp/tools-reference">
    Complete catalog of 120+ MCP tools.
  </Card>
</CardGroup>

## Authentication

All SDKs authenticate with a DevHelm API token:

<CodeGroup>
  ```typescript TypeScript theme={null}
  import { Devhelm } from "@devhelm/sdk";
  const client = new Devhelm({ token: process.env.DEVHELM_API_TOKEN });
  ```

  ```python Python theme={null}
  import os
  from devhelm import Devhelm
  client = Devhelm(token=os.environ["DEVHELM_API_TOKEN"])
  ```
</CodeGroup>

In the Python SDK, `token` may be omitted — it falls back to the `DEVHELM_API_TOKEN` environment variable. The TypeScript SDK requires `token` explicitly in the constructor.

## Next steps

<CardGroup cols={2}>
  <Card title="TypeScript quickstart" icon="rocket" href="/sdk/typescript/quickstart">
    Create your first monitor with the TS SDK.
  </Card>

  <Card title="Python quickstart" icon="rocket" href="/sdk/python/quickstart">
    Create your first monitor with the Python SDK.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Full REST API documentation.
  </Card>
</CardGroup>