caspian-sdk
Agent communication SDK. The open-source agent communication layer for AI agents — email, WhatsApp, Slack, Discord, Telegram, SMS. Python & TypeScript.
Caspian SDK is an open-source agent communication layer that enables AI agents to send and receive messages across multiple platforms—email, WhatsApp, Slack, Discord, Telegram, SMS, and more—from a single unified interface. Available in both Python and TypeScript, it eliminates the need for custom channel adapters by providing a declarative API where developers add channels with one line and handle all messages through normalized thread and message objects. Agents can deploy in hosted mode (polling the Caspian gateway) or self-host mode (using their own tokens and webhooks), with automatic webhook verification, threading, typing indicators, and rich message formatting across all channels.
Key Features
Use Cases
- 01Customer support agents that answer inquiries across email, Slack, Instagram DM, and other channels from a single bot instance
- 02Sales and lead follow-up agents that initiate and continue conversations on the channel each lead prefers
- 03Personal and executive assistant agents with one unified identity across email, Telegram, Slack, and SMS
- 04Community and product support bots deployed simultaneously in Discord servers, Slack workspaces, and direct messages
- 05Multi-channel notification and workflow agents that decide at runtime which platform to use for each message
- 06Agent frameworks integrating communication capabilities without maintaining separate adapters for each platform
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
caspian-sdk — FAQ
What is the Caspian SDK?+
Caspian SDK is an open-source communication layer for AI agents that provides a unified API to send and receive messages across platforms like Slack, Discord, Telegram, email, WhatsApp, SMS, and more. It handles webhook verification, threading, platform quirks, and message normalization so agents can communicate with humans on any channel from a single codebase.
How do I install the Caspian SDK?+
Install via pip install caspian-sdk for Python (3.10+) or npm install caspian-sdk for TypeScript/Node.js (18+). For hosted mode, obtain an API key from dashboard.trycaspianai.com and set it as CASPIAN_API_KEY. For self-hosted mode, provide your own platform tokens (bot tokens, signing secrets) when adding channels.
Which AI agent frameworks and clients work with Caspian?+
Caspian works with any Python or TypeScript/Node.js agent framework including OpenClaw (via @trycaspian/caspian skill), OpenCode (via caspian-opencode-plugin), and custom agents built with Claude Code, Codex, Cursor, Kimi, or other coding assistants. It provides integrations for these platforms and can be added to any agent that can import Python or TypeScript libraries.
Do I need API keys or tokens for each platform?+
In hosted mode, Caspian manages most channels (email, WhatsApp, SMS) with just your Caspian API key; Telegram requires your own BotFather token. In self-host mode, you provide all platform credentials—Telegram bot tokens, Slack bot tokens and signing secrets, Discord tokens, email SMTP/IMAP credentials, etc.
Is the Caspian SDK free to use?+
Yes, the Caspian SDK is open-source (Apache-2.0 license for the repository, MIT for the PyPI package). Self-hosted mode is entirely free. Hosted mode uses the Caspian gateway at api.trycaspianai.com, which requires an API key; check trycaspianai.com for gateway pricing and included channels.
Can I use Caspian without exposing a public webhook URL?+
Yes, in hosted mode your process polls the Caspian gateway via cx.run() with no public URL needed. In self-host mode, Discord and Slack adapters support socket-based inbound connections (cx.listen('discord') or cx.listen('slack')) that also avoid public webhooks, though optional dependency installation is required.
How do I install caspian-sdk?+
Open the source repository on GitHub and follow its README. caspian-sdk is a skill — MCP Agents Market links you directly to the official repo.
Is caspian-sdk free?+
caspian-sdk is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.