[Coming soon] Connect an AI Assistant to Switchboard (MCP Server)

Last updated: July 22, 2026

Switchboard's MCP server lets AI assistants like Claude and ChatGPT work directly with your Switchboard data — browsing phones/emails, broadcasts, email blasts, audiences, and more — using only the permissions your account already has.

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools securely. Instead of copying and pasting data between Switchboard and your AI assistant, the assistant can look things up, run exports, and answer questions about your program directly.

Getting Connected

Endpoint URL

https://api.oneswitchboard.com/mcp

This URL is meant for AI assistants, not browsers. Use the setup instructions below to connect your preferred client.

Claude (web or desktop app)

  1. Open Settings, then Connectors, and choose Add custom connector.

  2. Paste the endpoint URL: https://api.oneswitchboard.com/mcp

  3. When prompted, sign in with your Switchboard account.

Claude Code (terminal)

Run this command to add the server:

claude mcp add --transport http switchboard https://api.oneswitchboard.com/mcp

Then run /mcp inside Claude Code to sign in with your Switchboard account.

ChatGPT

  1. Go to Settings, then Apps & Connectors, then Advanced settings to enable developer mode.

  2. From Apps & Connectors, choose Create to add a custom connector and paste the endpoint URL.

  3. Pick OAuth authentication and sign in with your Switchboard account when prompted.

Try it

Start with a simple ask to make sure everything is working, for example:

Give me quick overview of the latest activity in my Switchboard orgs

What You Can Do

The MCP server currently provides read-only access to your Switchboard data. Your AI assistant can browse, look up, and export data — but cannot create, modify, or send anything.

Browse and look up

  • Phones — List phone numbers, look up a specific phone by number, view a phone's conversation thread (message history).

  • Emails — List email addresses, look up a specific email by address.

  • Broadcasts — List and search broadcasts (bulk text message sends), view broadcast details and individual messages sent.

  • Email blasts — List and search email blasts (bulk email sends), view blast details and individual messages sent.

  • Audiences — List and view phone lists, email lists, and saved searches. Phone lists and email lists are static (their membership is fixed at creation). Saved searches are dynamic (they store filter criteria rather than a fixed set of phones or emails).

  • Labels — List and view labels (tags applied to phones and emails, used to organize and build audiences).

  • Media — List uploaded media files (images, videos, audio, vCards) used as MMS attachments in broadcasts.

  • Jobs — Check the status of export jobs and poll until they complete.

Export data

For complete datasets — like all phones in a list or all messages in a broadcast — the assistant can run exports that produce downloadable CSV files. Available exports include:

  • All phones or emails in an organization

  • All phone numbers in a phone list, email list, or saved search

  • All broadcasts or all messages in a specific broadcast

  • All email blasts or all messages in a specific email blast

  • Phone opt-outs (phone numbers that opted out of texts, e.g. by texting STOP)

  • Email unsubscribes (email addresses that opted out of email communications)

  • Inbox messages (incoming text message replies, organized as conversation threads)

Exports run in the background and typically complete within a few minutes. The assistant will poll for completion and share the download link when ready.

Access and Permissions

  • You need an active Switchboard account. Your assistant gets the same access your account has — no more, no less.

  • If your account has access to multiple organizations, the assistant can work across all of them. Ask it to tell you which organizations you have access to.

  • You can disconnect the assistant at any time from your AI client's settings.

Getting Help