Give your agent communication in one paste.
The most reliable paste: point your agent at the always-current guide and it wires the integration itself. Copy the one-liner below — your coding agent reads /SKILL.md from the gateway and sets everything up, so it never drifts from the API.
Read https://api.trycaspianai.com/SKILL.md in full, then set up Caspian so you can message me on any channel. Follow that guide exactly — install the SDK, run `caspian init`, and connect a channel (email, Telegram, Slack, and Discord are free and instant). You'll need internet access to fetch the guide.
Or skip the install: add the MCP server
If you work in Cursor, Claude Code, or any MCP client, there is nothing to install and no key to copy. Add one URL and the agent gains the tools to send and receive. Ask it to call get_started and it mints its own key.
{
"mcpServers": {
"caspian": {
"url": "https://api.trycaspianai.com/mcp"
}
}
}
Then: "Use the caspian MCP server: call get_started, connect email, and show me the address." It can read what arrives with inbox and answer with reply. MCP docs →
Prefer to paste the whole guide inline instead? Expand it
# Caspian: communication for your agent
You can reach any human on any channel through Caspian, with one persistent
identity. You never build or maintain messaging infrastructure.
## Set up (once)
pip install caspian-sdk # SDK + the `caspian` CLI
caspian init # mint a key, write .env (hosted by default)
# Paid channels (x, whatsapp, imessage) need a one-time `caspian login` + prepaid credit.
## Receive + reply — the whole loop
# Ask the human what the mailbox should be called BEFORE connecting email:
# a bare channels.add("email") mints a random local-part.
import os
from caspian import Caspian, HandlerContext, Message, Thread
cx = Caspian(
api_key=os.environ["CASPIAN_API_KEY"], # it does not read .env by itself
base_url=os.environ.get("CASPIAN_BASE_URL", "https://api.trycaspianai.com"),
)
cx.channels.add("email", username="") # -> @agents.trycaspianai.com
@cx.on_message({"channel": "email"})
def handle(thread: Thread, msg: Message, ctx: HandlerContext) -> None:
thread.post(my_agent(msg.text)) # answers in the right thread
cx.run() # hosted: poll the gateway forever
The same handler serves every channel you add — telegram, slack, discord.
`caspian channels add ` is the CLI twin of `channels.add`.
## No install? Use the MCP server
Add https://api.trycaspianai.com/mcp to Cursor or Claude Code and ask the agent
to call get_started. It mints a key, connects a channel, and reads and answers
with the inbox and reply tools — nothing installed, no key to copy.
## What you get
- One identity: an inbox, a handle, a number. The same agent everywhere.
- Free channels instant (email, Telegram, Slack, Discord); paid run on prepaid credit.
- Lifecycle handled: reconnects, retries, rate limits, deliverability, threading.
Full, always-current agent guide is served at your gateway: /SKILL.md (and /llms.txt).
The full, always-current guide is served at your gateway as /SKILL.md and /llms.txt, so the pointer above never drifts from the API. View SKILL.md →