diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 50f8c271..565f5e3b 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -428,6 +428,11 @@ "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." + }, { "name": "robinhood", "source": "third_party/robinhood", diff --git a/README.md b/README.md index f5e95e01..8aff04ae 100644 --- a/README.md +++ b/README.md @@ -86,6 +86,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. | | `robinhood` | [Robinhood](third_party/robinhood/) | Cursor | Integrations | View portfolios, positions, orders, watchlists, and market data, and trade in a Robinhood Agentic account. | | `coinbase` | [Coinbase](third_party/coinbase/) | Cursor | Integrations | Check balances, get quotes, and preview or place trades. | | `etoro-trading` | [eToro Trading](third_party/etoro-trading/) | Cursor | Integrations | View your eToro portfolio, balances, positions, and watchlists, research instruments and traders, and prepare and place trades. | diff --git a/third_party/swarms/.cursor-plugin/plugin.json b/third_party/swarms/.cursor-plugin/plugin.json new file mode 100644 index 00000000..6650325b --- /dev/null +++ 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 new file mode 100644 index 00000000..9fbf423d --- /dev/null +++ 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 new file mode 100644 index 00000000..ca2bba77 --- /dev/null +++ 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 new file mode 100644 index 00000000..93a8143e --- /dev/null +++ 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 new file mode 100644 index 00000000..016d85b7 Binary files /dev/null and b/third_party/swarms/assets/logo.png differ diff --git a/third_party/swarms/mcp.json b/third_party/swarms/mcp.json new file mode 100644 index 00000000..4098c62d --- /dev/null +++ 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}" + } + } + } +}