cursor · kyegomez · Sep 21, 2026
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
@@ -412,6 +412,11 @@
       "name": "statsig",
       "source": "third_party/statsig",
       "description": "Inspect and manage feature gates, experiments, dynamic configs, and metrics."
+    },
+    {
+      "name": "swarms",
+      "source": "third_party/swarms",
+      "description": "Run agents, orchestrate multi-agent swarms, and process batches."
     }
   ]
 }
diff --git a/README.md b/README.md
@@ -83,6 +83,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
 | `excalidraw` | [Excalidraw](third_party/excalidraw/) | Cursor | Integrations | Draw and export hand-drawn diagrams from chat. |
 | `google-cloud-bigquery` | [Google Cloud BigQuery](third_party/google-cloud-bigquery/) | Cursor | Integrations | Explore datasets and tables and run SQL queries. |
 | `statsig` | [Statsig](third_party/statsig/) | Cursor | Integrations | Inspect and manage feature gates, experiments, dynamic configs, and metrics. |
+| `swarms` | [Swarms](third_party/swarms/) | Cursor | Integrations | Run agents, orchestrate multi-agent swarms, and process batches. |
 Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest).
 
 ## Repository structure

diff --git a/third_party/swarms/.cursor-plugin/plugin.json b/third_party/swarms/.cursor-plugin/plugin.json
@@ -0,0 +1,51 @@
+{
+  "name": "swarms",
+  "displayName": "Swarms",
+  "version": "1.0.0",
+  "minClientVersions": {
+    "cursor": "3.13.0"
+  },
+  "description": "Run agents, orchestrate multi-agent swarms, and process batches.",
+  "author": {
+    "name": "Cursor",
+    "email": "plugins@cursor.com"
+  },
+  "homepage": "https://docs.swarms.ai/docs/documentation/clients/swarms-api-mcp",
+  "repository": "https://github.com/cursor/plugins",
+  "license": "MIT",
+  "logo": "assets/logo.png",
+  "keywords": [
+    "swarms",
+    "agents",
+    "multi-agent",
+    "orchestration",
+    "swarm",
+    "workflows",
+    "batch processing",
+    "reasoning",
+    "llm",
+    "mcp"
+  ],
+  "category": "integrations",
+  "tags": [
+    "swarms",
+    "agents",
+    "multi-agent",
+    "orchestration",
+    "mcp"
+  ],
+  "variables": {
+    "type": "object",
+    "properties": {
+      "SWARMS_API_KEY": {
+        "type": "string",
+        "title": "Swarms API key",
+        "description": "API key from https://swarms.world/platform/api-keys."
+      }
+    },
+    "required": [
+      "SWARMS_API_KEY"
+    ]
+  },
+  "mcpServers": "./mcp.json"
+}
diff --git a/third_party/swarms/CHANGELOG.md b/third_party/swarms/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `swarms` MCP server pointing at Swarms' hosted Streamable HTTP endpoint (`https://mcp.swarms.world/mcp`), exposing 23 tools across agents, swarms, specialized workflows, models, and account monitoring.
+- Auth uses a Swarms API key supplied by the user as an `x-api-key` header (`${SWARMS_API_KEY}`).
+- Logo: Swarms' official mark, from the `The-Swarm-Corporation` GitHub organization.
diff --git a/third_party/swarms/LICENSE b/third_party/swarms/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/swarms/README.md b/third_party/swarms/README.md
@@ -0,0 +1,75 @@
+# Swarms
+
+Cursor plugin that connects agents to the [Swarms API](https://swarms.ai) through Swarms' official hosted remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Run a single agent, orchestrate a multi-agent swarm across 14 architectures, execute graph and batched-grid workflows, generate an agent roster from a plain-language task, and fan work out in parallel batches — all from chat.
+
+Official Cursor setup: https://docs.swarms.ai/docs/documentation/clients/swarms-api-mcp
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Swarms**.
+3. Click **Install**, then set your Swarms API key (below).
+
+Or run `/add-plugin swarms` in chat.
+
+## MCP
+
+```json
+{
+  "mcpServers": {
+    "swarms": {
+      "type": "http",
+      "url": "https://mcp.swarms.world/mcp",
+      "headers": {
+        "x-api-key": "${SWARMS_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Auth is a Swarms **API key** sent in an `x-api-key` header. Create one at https://swarms.world/platform/api-keys, then set it in **Dashboard → Plugins → Configure**. Do not commit the key.
+
+## Before you connect
+
+You need a Swarms account and an API key with credits. The server holds no key of its own — it forwards the key on each request to `https://api.swarms.world`, so every call runs against your account and spends your credits. The key travels as a transport header and is never a tool argument, so the model driving the tools never sees it.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Agents | Execute a single agent completion with a full agent spec (model, system prompt, loops, tools, images), run many agent completions in parallel, and list agent configurations you have created |
+| Swarms | Execute a multi-agent swarm over `SequentialWorkflow`, `ConcurrentWorkflow`, `HierarchicalSwarm`, `MixtureOfAgents`, `GroupChat`, `MajorityVoting`, `AgentRearrange`, `MultiAgentRouter`, `CouncilAsAJudge`, `LLMCouncil`, `DebateWithJudge`, `HeavySwarm`, `RoundRobin`, or `PlannerWorkerSwarm`; run swarms in parallel batches; list available architectures |
+| Specialized workflows | Graph workflows with directed agent nodes and edges, batched grid workflows, reasoning agents with their type list, and an auto agent builder that designs a roster from a task description |
+| Models and tools | List available models, list models in OpenAI-compatible shape, OpenAI-compatible chat completions, and list available API tools |
+| Account and monitoring | Rate limits and usage, credit balance, pricing details, metrics summary, request logs, premium endpoint availability, and health |
+
+23 tools in total. The hosted runtime is the source of truth for tool names and schemas.
+
+## Notes
+
+- Tool calls run with the permissions and credits attached to the API key, and are billed the same way the REST API is. Check `credit_balance_v1_account_credits_get` and `usage_costs_v1_usage_costs_get` before long runs.
+- Swarm and batch runs can be long and expensive — a swarm accepts up to 2000 agents and 50 loops. Confirm the shape of the run before launching one from chat.
+- Some endpoints, including batched grid workflows, are premium-only. `premium_endpoints_v1_account_premium_endpoints_get` returns the current list.
+- `tools/list` works without a key, so the tool surface is discoverable before you authenticate; only tool calls need credentials.
+- Two tool names are truncated with a stable hash suffix (`..._comple_a8b363`, `..._comple_0dda3b`) because MCP caps tool-name length. Use them exactly as the runtime lists them.
+- Tool results carry `structuredContent` alongside the text rendering, so results parse without string handling. Upstream failures come back as `isError: true`, not transport exceptions.
+- Revoke access at any time by deleting the key from the Swarms API keys page.
+
+## Docs
+
+- Swarms API MCP server: https://docs.swarms.ai/docs/documentation/clients/swarms-api-mcp
+- Documentation home: https://docs.swarms.ai
+- Quickstart: https://docs.swarms.ai/docs/documentation/getting-started/quickstart
+- Multi-agent architectures: https://docs.swarms.ai/docs/documentation/multi-agent/available-architectures
+- Pricing and rate limits: https://docs.swarms.ai/docs/documentation/resources/pricing
+- API keys: https://swarms.world/platform/api-keys
+- Server URL: https://mcp.swarms.world/mcp
+
+Logo is Swarms' official mark, from the `The-Swarm-Corporation` GitHub organization.
+
+## License
+
+MIT
diff --git a/third_party/swarms/assets/logo.png b/third_party/swarms/assets/logo.png
diff --git a/third_party/swarms/mcp.json b/third_party/swarms/mcp.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "swarms": {
+      "type": "http",
+      "url": "https://mcp.swarms.world/mcp",
+      "headers": {
+        "x-api-key": "${SWARMS_API_KEY}"
+      }
+    }
+  }
+}