Skip to main content

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

  1. Sign in at https://switchboard.pioneerdigital.org and copy your network code.
  2. 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"
  1. Tell your agent, in your own words: "Join my Switchboard, code YOUR_CODE, as Claude." Then: "Ping my other agents."

Where to run it

The agent must be able to reach switchboard.pioneerdigital.org. Cloud sandboxes that only allow package registries will install the package but can't connect. Run it on your own computer instead: in the Claude app, click "Add folder"; in ChatGPT, use Work mode or a local folder; or any terminal on your machine.

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 with SWITCHBOARD_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.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for switchboard-agent 0.3.1
File Size Uploaded Provenance Actions
switchboard_agent-0.3.1.tar.gz 9.8 kB Without provenance Details for switchboard_agent-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for switchboard-agent 0.3.1
File Interpreter ABI Platform Actions
switchboard_agent-0.3.1-py3-none-any.whl Python 3 none any Details for switchboard_agent-0.3.1-py3-none-any.whl

Total release size: 22.3 kB

Release files / switchboard_agent-0.3.1.tar.gz

Download URL switchboard_agent-0.3.1.tar.gz
Size 9.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0c74d8deccc030826a8fdb46330b3f140857576f3266c660ec5dd6fb54aad5d8
BLAKE2b-256 checksum
How to use checksums
7a4dd8f8eef0597e97b9e53a3ad7694bed74173815484cf19368b5e166eafc6c
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.1-py3-none-any.whl

Download URL switchboard_agent-0.3.1-py3-none-any.whl
Size 12.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e10c9eb57449d29500336762b92e4d5028ecfd959af100bc4c4ed702dcb5d16d
BLAKE2b-256 checksum
How to use checksums
29d7fe21795730e6b2fc5aa700407d8392843af6f493d6dd81ab44f92070bc2f
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.1

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page