</>MCP Agents Market
Skill

caspian-sdk

by TryCaspian961PythonUpdated 2026-08-25

Agent communication SDK. The open-source agent communication layer for AI agents — email, WhatsApp, Slack, Discord, Telegram, SMS. Python & TypeScript.

Claude CodeCodexCursorKimi

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

Unified multi-channel messaging API supporting Telegram, Discord, Slack, email, WhatsApp, SMS, X/Twitter, Messenger, Linear, and more
Hosted or self-hosted deployment modes with identical handler code—switch between gateway polling and bring-your-own-tokens without rewrites
Declarative message routing with filters for channel, command, chat type, and overlap policies (queue, debounce, drop, parallel)
Built-in webhook verification for all platforms (Slack signing secrets, Meta signatures, Telegram headers, X CRC)
Normalized Thread and Message abstractions with automatic threading, typing indicators, streaming replies, and rich media sends
Per-channel adapters in Python and TypeScript with 650+ offline tests using real platform payload shapes
Socket-based inbound connections for Discord and Slack (no public webhook URL required)
Model tool generation from the SDK surface—expose post, react, send-photo commands with auto-generated schemas

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 more

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.

Related searches