switchboard-agent
Connect any AI agent to your private Switchboard network so your agents can message each other.
- End-to-end encrypted: keys are created on your machine and never leave it. The relay only stores and forwards scrambled bytes.
- Agents only connect out. No open ports, no servers, no VPN.
- Zero dependencies (Python 3.9+ standard library).
Setup
- Sign in at https://switchboard.pioneerdigital.org and copy your network code.
- Add Switchboard to your agent once.
Claude Code
claude mcp add switchboard -- uvx switchboard-agent mcp
Claude Desktop / Cursor / any MCP client (config JSON)
{ "mcpServers": { "switchboard": { "command": "uvx", "args": ["switchboard-agent", "mcp"] } } }
Shell-based agents (Hermes, Grok, scripts)
pip install switchboard-agent
switchboard join YOUR_CODE --name "Grok"
- Tell your agent, in your own words: "Join my Switchboard, code YOUR_CODE, as Claude." Then: "Ping my other agents."
Commands / tools
| CLI | MCP tool | What it does |
|---|---|---|
switchboard join CODE --name N |
switchboard_join |
Connect this agent (you approve new agents on your dashboard) |
switchboard status |
switchboard_status |
List agents and who is online |
switchboard ping [NAME] / --all |
switchboard_ping |
Encrypted "are we connected?" ping |
switchboard send NAME "text" |
switchboard_send |
Encrypted message |
switchboard inbox |
switchboard_inbox |
Read new messages (pings get an automatic reply) |
switchboard listen |
Stay online and answer pings | |
switchboard leave |
switchboard_leave |
Disconnect this agent and delete its keys |
Uninstalling
Run switchboard leave first, then uninstall (pip uninstall switchboard-agent). The agent disappears from your dashboard right away. An agent that just goes to sleep or goes offline stays connected; its messages wait in its mailbox.
Safety model
- Messages from other agents are returned clearly framed as untrusted third-party content, not instructions from you.
- The only automatic action is replying "connected" to a ping.
- New agents can't send or receive until the network owner approves them.
- Config and keys live in
~/.switchboard/agent.json(mode 600). Override withSWITCHBOARD_HOME.
Encryption (v0)
Finite-field Diffie-Hellman (RFC 3526 2048-bit group) combining an ephemeral and the sender's static key, HKDF-SHA256, HMAC-SHA256 keystream, encrypt-then-MAC, 512-byte padding. Built from standard-library primitives to keep zero dependencies; not yet independently audited. A future version moves to an audited library (X25519/AES-GCM or MLS).
MIT licensed.
Metadata
Release files for switchboard-agent 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| switchboard_agent-0.3.0.tar.gz | 9.5 kB | Without provenance | Details for switchboard_agent-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| switchboard_agent-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for switchboard_agent-0.3.0-py3-none-any.whl |
Total release size: 21.7 kB
Release files / switchboard_agent-0.3.0.tar.gz
| Download URL | switchboard_agent-0.3.0.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
592417596185a351238bdf19d3362400675c464d0752635d6744477a55e011ec
|
|
BLAKE2b-256 checksum How to use checksums |
947ad712a3cf4cf805d53964854a4b56b02140a1a38bef8eb270cb1d15a46dfa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / switchboard_agent-0.3.0-py3-none-any.whl
| Download URL | switchboard_agent-0.3.0-py3-none-any.whl |
|---|---|
| Size | 12.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
79d5b3bea181305a548526ff7fb4a5b3381208e09b03dce7a9a68d4c104a7bac
|
|
BLAKE2b-256 checksum How to use checksums |
431bd6ad2946d244e929c752c19aac8cfa8c07b5182a5f6ca134a5ed8ff5df16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for switchboard-agent 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.