Skip to main content

Set up the connection

1

Add the SuprSend MCP server

Run MCP: Add Server from the command palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows and Linux). Choose HTTP, paste https://mcp.suprsend.com/mcp, and name the server suprsend.Choose Global to use it in every project, or Workspace to save it to .vscode/mcp.json in the current project.If that doesn’t work, add the server to mcp.json yourself. Run MCP: Open User Configuration, or create .vscode/mcp.json in your project, and add:
2

Sign in with your SuprSend account

When you save the server, VS Code starts it, asks you to sign in, and opens your browser. Sign in with your SuprSend account. The agent gets the same permissions your role has in the SuprSend dashboard.
3

Verify the connection

Open Copilot Chat and switch it to Agent mode. MCP tools only work in Agent mode. Check that the SuprSend tools are on in the tools picker, then ask:
Copilot answers with your SuprSend workspaces.

Pin a workspace and restrict tools

By default, Copilot can use every workspace and tool your role allows. To keep it on one workspace, or to give it only the tools a job needs, use one of these URLs when you add the server, or in mcp.json:
  • Pin a workspace by adding its slug to the path. The agent then can’t switch to another workspace:
  • Restrict tools with ?tools=, a comma-separated list of tool names or groups:
See Scope the connection for every URL pattern, and the tool list for every tool.

Troubleshooting

Check the workspace slug in the URL. It must match a workspace in your SuprSend account exactly, for example staging, not the workspace’s display name. A slug that doesn’t exist fails with 403 workspace_forbidden. To see your slugs, remove the slug, reconnect, and ask: “List my SuprSend workspaces.”
Check that Copilot Chat is in Agent mode and the SuprSend tools are on in the tools picker. The ?tools= filter may also be too strict: remove it and save the config again.
User-level mcp.json syncs through VS Code’s Settings Sync. If another machine’s sync replaces your SuprSend entry, re-add it on the current machine and sync pushes the merged config.

Tool list

Every tool, grouped by category, with read vs write labels.

Prompt cheatsheet

Ready-to-use prompts to get started fast.