SDKs Overview - DevHelm

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

TypeScript SDK

Typed client for Node.js and browser environments. Full CRUD on all resources with auto-pagination.

Python SDK

Sync and async clients for Python 3.11+. Pydantic models for type safety.

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.

MCP Server

Connect your AI assistant in 30 seconds.

Tools reference

Complete catalog of 120+ MCP tools.

Authentication

All SDKs authenticate with a DevHelm API token:

import { Devhelm } from "@devhelm/sdk";
const client = new Devhelm({ token: process.env.DEVHELM_API_TOKEN });

import os
from devhelm import Devhelm
client = Devhelm(token=os.environ["DEVHELM_API_TOKEN"])

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

TypeScript quickstart

Create your first monitor with the TS SDK.

Python quickstart

Create your first monitor with the Python SDK.

API Reference

Full REST API documentation.

​SDKs

TypeScript SDK

Python SDK

​Quick comparison

​MCP Server

MCP Server

Tools reference

​Authentication

​Next steps

TypeScript quickstart

Python quickstart

API Reference

SDKs

Quick comparison

MCP Server

Authentication

Next steps