# Dyspatch MCP Server


The Dyspatch MCP server lets AI agents work in your Dyspatch account on your behalf. Describe what you want in natural language and your AI tool creates and reviews drafts, manages localizations, and organizes content for you.

## How the MCP Server Works

Each person creates and manages their own MCP server connection, so the AI acts as you:

- **Actions are taken as you.** Anything the agent does in Dyspatch appears as if you did it yourself.
- **It can do what you can do in the UI.** Most anything available to you in Dyspatch is available through the MCP server. Note: Some destructive actions like user and API key removal is not permitted.
- **Your permissions apply.** If your role or workspace permissions don't allow an action in the UI, the agent can't do it either.
- **Edits need your approval.** Requests that edit files require your approval.

<div class="highlight note">Many AI providers offer modes that approve actions on your behalf, so check your tool's settings if you want fewer prompts.</div>

## Supported Agents

You can connect these AI tools to the MCP server:

- Claude, in the Claude desktop app and Claude Code
- Cursor
- Grok
- OpenAI
- VS Code with GitHub Copilot
- Nearly any AI provider that supports a manual MCP connection

## Connecting an Agent

1. In Dyspatch, open the <a href="https://app.dyspatch.io/mcp-server" target="_blank">MCP Server Dashboard</a> from the Dyspatch homepage.
2. Find your AI provider and follow its connection instructions or Launch App link.
3. When you use the MCP server for the first time, approve the connection to Dyspatch in the pop-up browser window.
4. Ask your AI tool what Dyspatch user you are or what workspaces you have to confirm the connection is active.

![MCP Server page of Dyspatch UI with an active Claude agent listed](https://docs.dyspatch.io/img/integrations/mcp-server-ui.png)

<div class="highlight note">If you don't see the MCP page in your account, contact your Account Manager or <a href="mailto:support@dyspatch.io?subject=Request%20access%20to%20MCP%20Agent%20Server">support@dyspatch.io</a>.</div>

## Managing Agent Connections

The MCP page lists every agent you have connected and allowed to work on your behalf. Review the list to see which agents have access to your account. You can also revoke access from any agent you've previously allowed to work in your account from here.

## What You Can Do with the MCP Server

The MCP server covers your template workflow. Some examples:

- **Review drafts:** "Show me all drafts needing approval in the Payments workspace."
- **Create content:** "Create a draft for a password reset email using the Marketing theme."
- **Localize:** "Which of my templates don't have a French localization?"
- **Organize:** "Tag all SMS templates in the Payments workspace as 'transactional'."
- **Audit:** "What are all of the blocks that haven't been updated this year."

## MCP Server Tips

- **Be specific.** "List all SMS templates tagged 'transactional' in the Payments workspace" gets better results than "show me templates."
- **Name the workspace.** If you work in more than one workspace, say which one to target.
- **Experiment with A/B versions.** Duplicate a template, make a small content change, and name the copy with "Version B" so you can compare approaches before choosing what to publish.
- **Try different models.** Your agent's model can affect the quality and creativity of its results. Use the model that works best for the task, and compare outputs when you want a fresh approach.
- **Preview changes with you AI provider's in-app Browser.** If your agent is using an app, and has browser access, use it to sign in to Dyspatch. It can then drive the UI to preview every template as it builds, letting the agent not only verify code but also see the effects of its changes.

## MCP Server Troubleshooting

**Connecting.** Ask your agent to connect to the Dyspatch MCP at `https://app.dyspatch.io/ai/mcp`, and it can assist you.

**Dyspatch doesn't appear as a connector.** Confirm the MCP page is available in your Dyspatch account. Some AI providers, like Claude Desktop, require your administrator to approve the connector before others can use it.

**The agent says it can't perform an action.** The MCP server follows your Dyspatch permissions. Check that you can do the same action in the Dyspatch UI, or ask an Admin to review your [user role](/administration/dyspatch_roles/).

**An agent isn't listed on the MCP page.** Reconnect it from your AI tool, then refresh the page.

Still stuck? Contact your Account Manager or <a href="mailto:support@dyspatch.io">support@dyspatch.io</a>.

<div class="highlight note">The legacy <a href="https://www.npmjs.com/package/dyspatch-mcp" target="_blank">dyspatch-mcp npm package</a> is no longer being updated. We recommend users try the MCP server above instead!</div>