Skip to main content
The Swarm MCP accepts your team’s API key in an x-api-key header, so any client that can send custom headers to a remote MCP server can connect — no OAuth consent screen and no Client ID required. Use this route for Cursor, Claude Code, VS Code, automation platforms, or your own code. If you’re on Claude or ChatGPT, use OAuth instead: Connect in Claude · Connect in ChatGPT.

​
Before you start

  • A Swarm account with the MCP integration enabled on your plan. If you’re not sure, contact support@theswarm.com.
  • A team API key. Generate one under Team Settings → API — this requires Owner or Admin access. See Get your API key.
  • An MCP client that supports a remote (HTTP) server with custom headers.

​
Server details

​
Configuration

Most clients read a JSON config file. The shape below is the common one — check your client’s docs for the exact file location and key name.
Some clients store headers under a different key (requestInit.headers, env, or a dedicated headers field in the UI). If yours doesn’t expose headers at all, use OAuth — or email us to have a Client ID registered for it.

​
Verify the connection

Open a new chat in your client and check the tools list — you should see The Swarm’s tools. Try a quick prompt:
“Find VP-level product leaders at Series B SaaS companies in London.”
The curl example above is the fastest way to confirm the key and endpoint work on their own, independently of any client. See Tools & prompts for the full tool list and more examples.

​
Credits and permissions

Billing is identical for both authentication methods — 1 credit per successful search on find_profiles, find_companies, and partner_network_mapper, with empty results free. See Credits and cost. The connection is read-only and scoped to the team the key belongs to.

​
Rotate or revoke

Generate a new key under Team Settings → API, then update the header in your client config. Revoking a key immediately cuts off every client using it.

​
Troubleshooting

  • 401 / unauthorized — the key is wrong, or it was rotated. Copy it again from Team Settings → API and confirm the header name is exactly x-api-key.
  • Server connects but no tools appear — restart the client so it re-runs discovery. If it still fails, run the curl call above: if that returns tools, the problem is in your client config.
  • Client sends no headers — check the config field name, or confirm your client supports custom headers on remote MCP servers at all.
  • Plan or permission errors — confirm your Swarm plan includes MCP access, and that the key was generated by an Owner or Admin.

​
Need help?

Contact support@theswarm.com and include your client (Cursor, Claude Code, etc.) and a description of what you were trying to do. Don’t send us your API key.