Developers
Open Swarmhit
DocumentationAPI Reference

MCP server

Connect AI agents to Swarmhit over the Model Context Protocol.

The same capabilities as the REST API are exposed to AI agents over the Model Context Protocol. Generate an MCP key under Settings → API & Webhooks → MCP Server, then connect any MCP client (Claude, ChatGPT, Clay, n8n, Make) to the Streamable HTTP endpoint:

https://app.swarmhit.com/mcp?key=swh_mcp_xxxxxxxxxxxxxxxxxxxxxxxx

The endpoint speaks JSON-RPC 2.0; its tools call the same handlers as the REST routes documented here, so behaviour matches one-to-one.

Acting as a workspace in your organization

An organization key can act on any workspace inside it by appending &workspaceId=<workspaceId> to the connection URL, one connection per workspace. See Authentication for how workspace scoping works, and Organization for the list_workspaces, get_workspace, create_workspace, update_workspace, delete_workspace, invite_workspace_member, update_workspace_member and remove_workspace_member tools.

get_workspace_info is the odd one out: it returns the workspace the connection resolves to, not one looked up by id.

Webhooks

Subscribe to Swarmhit events, verify signed deliveries, and handle every event type with example payloads.

Organization

Manage the workspaces inside your organization from one API key, allocate sender seats, and act on any of them with a single request header.

On this page

Acting as a workspace in your organization