SDKs & Libraries

There is no published SDK yet

We don't currently publish an official npm or PyPI client library. Rather than ship one that lags the API, we point you at two first-class, fully supported ways to integrate:

1. The REST API — a plain HTTP API you can call from any language.
2. The hosted MCP server — connect an IDE or AI assistant and drive your account with no client library at all.

When an official package is published, this page will document its install and usage. Until then, the examples below are the supported path.

Call the REST API directly

Authenticate with a bearer key (generated under Settings → API Keys) and call the API with your HTTP client of choice.

# List your agents
curl https://api.customagents.io/v1/agents \
  -H "Authorization: Bearer ca_acct_YOUR_KEY"

// Node.js — no dependencies required
const res = await fetch("https://api.customagents.io/v1/agents", {
  headers: { Authorization: `Bearer ${process.env.CUSTOM_AGENTS_API_KEY}` },
});
const agents = await res.json();

# Python — using requests
import os, requests

res = requests.get(
    "https://api.customagents.io/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['CUSTOM_AGENTS_API_KEY']}"},
)
agents = res.json()

See the API Reference for the full endpoint list, and API Keys & Scopes for the scope model.

Or connect over MCP

If you're building from an IDE or an AI assistant, the hosted MCP server exposes your account as tools — send email and SMS, read conversations, manage agents — with nothing to install. For a single agent, see Per-Agent API & MCP.