> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.