Skip to main content
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

FeatureTypeScriptPython
Package@devhelm/sdkdevhelm
RuntimeNode.js 18+, browsersPython 3.11+
HTTP libraryopenapi-fetchhttpx
TypesOpenAPI-generated TypeScriptPydantic models
AsyncNative (Promise-based)Sync only; use asyncio.to_thread for concurrency
Paginationlist() auto-fetches, listPage() for manuallist() auto-fetches, list_page() for manual
Both SDKs provide the same resource coverage:
NamespaceOperations
Monitorslist, get, create, update, delete, pause, resume, test, results, versions
Incidentslist, get, create, resolve
Forensicsincident timeline, check trace, policy snapshot, rule evaluations, transitions
Alert channelslist, get, create, update, delete, test
Notification policieslist, get, create, update, delete, test
Tagslist, get, create, update, delete
Environmentslist, get, create, update, delete
Secretslist, create, update, delete
Resource groupslist, get, create, update, delete, add/remove members
Webhookslist, get, create, update, delete, test
API keyslist, create, revoke, delete
Dependencieslist, get, track, update alert sensitivity, delete
Deploy lockacquire, current, release, force-release
Maintenance windowslist, get, create, update, cancel
Services (status catalog)search, get, live status, uptime, incidents, maintenances, categories, summary
Statusoverview
Status pagespages, 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.