- CollectionCommunication
- Classificationagent-native
- LicenseThe root repository is AGPL-3.0 according to its actual LICENSE and GitHub metadata, despite the root README's Apache-2.0 badge/text. The Python and TypeScript SDK subdirectories separately carry MIT license files; verify the scope of the artifact you use.
- MCPPlanned
- Agent SkillAvailable
- InterfacesURL onboarding · Agent Skill · REST · webhook · CLI · SDK · http · API
- Verified2026-09-26
What it does
Caspian gives one AI agent a normalized communication layer across email, Slack, Discord, Telegram, GitHub, Instagram, Facebook Messenger, X, Bluesky, and additional hosted channels. The agent uses one message handler and one reply abstraction while adapters handle platform payloads, thread routing, signature verification, reconnection, and capability differences.
Its defining model is that channels are transports rather than separate identities. Caspian can scope connections to explicit customer and agent records, deliver ordered events with conversation and connection identifiers, and return channel-specific etiquette through behavior_prompt() for the model’s context.
Agent-facing interfaces
- Catalog protocols: URL onboarding, Agent Skill, REST, webhook, CLI, SDK, http, API
- MCP: ⚠️ Not yet published. The official roadmap lists an MCP server as future work; the current verified surfaces are URL onboarding, SDKs, CLI, REST/event APIs, and webhooks.
- Agent Skill: ✅ Available — both a live URL-onboarding skill and an official ClawHub package are documented upstream.
- Onboarding type:
url
How agents onboard
Integrate Caspian so my agent can message people on email, Slack, Discord, Telegram, and more.
Read https://api.trycaspianai.com/SKILL.md and follow it end to end.
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| URL onboarding | Live machine-readable guide at https://api.trycaspianai.com/SKILL.md |
| Python SDK | caspian-sdk on PyPI; CommClient, channel connects, messages, events, and webhooks |
| TypeScript SDK | caspian-sdk on npm with the same contract and camelCase API |
| CLI | caspian-cli for project initialization, channel connection, and event tailing |
| REST / events | Hosted or self-hosted gateway, including ordered /v1/events access |
| Webhooks | Signed inbound webhook ingestion and serverless handle_webhook() dispatch |
| MCP | Not yet shipped; listed on the official roadmap |
Verification
Last verified 2026-09-26.
Sources:
- https://github.com/TryCaspian/caspian-sdk/releases/tag/v0.1.2
- https://api.trycaspianai.com/SKILL.md
- https://api.github.com/repos/TryCaspian/caspian-sdk