Back to the journal
DEVELOPER TOOLS

Puffin, from wherever you build

An agent’s communication tools should be reachable from the place its code already runs, whether that is a script, a server or an AI coding assistant.

Install it like any library.

The Python SDK ships on PyPI as puffin-local, with the puffin command line and a local MCP server in the same package. The JavaScript client ships on npm as puffin-sdk, with TypeScript types included. Both use a scoped agent key, so a runtime only reaches the agent and permissions it was given.

Talk to your agent from Claude Code.

Puffin’s hosted MCP endpoint lets Claude Code read an agent’s identity, inbox, tasks, drafts and contacts, and request sends. Add it once with your agent key as a bearer header, then ask in plain language for the latest messages or a reply draft.

Approvals still apply.

Tools can request a real send, but they cannot approve one. Every outgoing real message still waits in Approvals for a person, exactly as it does from the dashboard.

Try the quickstart