squad-mcp
If you are the rightful owner of squad-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Squad MCP Server connects the Squad AI-powered product-discovery platform to any MCP-aware LLM application, allowing seamless interaction with product-strategy artefacts.
Squad MCP Server
A Model Context Protocol (MCP) server that connects Squad â the AIâpowered productâdiscovery and strategy platform â to any MCPâaware largeâlanguageâmodel (LLM) application. It exposes a rich toolâkit for creating, querying and updating productâstrategy artefacts (opportunities, solutions, outcomes, requirements, knowledge, workspaces and feedback) directly from your favourite AI coâpilot.
This repository also contains the source code for the @squadai/tools NPM package, which provides the client-side tools for interacting with the Squad API.
Why?
With the Squad MCP Server you can research, ideate and plan products in one conversational flow, without ever leaving your editor or chat window.
⨠Tools
| Tool prefix | Purpose | Typical actions |
|---|---|---|
| opportunity_* | Discover and refine product opportunities | create, list, update |
| solution_* | Generate and iterate on solutions | create, list, update |
| outcome_* | Track desired business or user outcomes | create, list |
| requirement_* | Capture detailed requirements | create, list |
| knowledge_* | Store useful referencesâŻ/âŻresearch | create, list |
| workspace_* | Manage Squad workspaces | get, update |
| feedback_* | Send customer or analytics feedback into Squad | create |
Each tool conforms to the MCP JSONâschema format so agents can introspect inputs and outputs automatically.
đ Quick start
1 ¡ Obtain a Squad API key
- Sign upâŻ/âŻsign in at https://meetsquad.ai.
- Open Settings â Developer â API Keys.
- Create a key and copy the value.
2 ¡ Run the server
Pick whichever installation method suits your environment.
Option A â Standâalone executableâŻ(recommended for local usage)
Download the latest binary for your operating system from the projectâs GitHub releases page and run it directly:
# Windows
squad-mcp.exe
# macOSâŻ/âŻLinux â make the file executable first
chmod +x squad-mcp
./squad-mcp
Pass environment variables in the usual way:
SQUAD_API_KEY=<yourâkey> SQUAD_ENV=production ./squad-mcp
Option B â DockerâŻ(recommended for production)
# Build the image (once)
docker build -t mcp/meet-squad -f Dockerfile .
# Run the server on stdio
docker run --rm -i \
-e SQUAD_API_KEY=<yourâkey> \
mcp/meet-squad
Option C â From source
git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
npm install
npm run build # transpiles to ./dist
node dist/index.js
đŚ NPM Package (@squadai/tools)
This repository also includes an NPM package, @squadai/tools, which provides a set of functions for interacting with the Squad API programmatically from your own Node.js applications or scripts.
To install the package:
npm install @squadai/tools
# or
yarn add @squadai/tools
# or
pnpm add @squadai/tools
You can then import and use the tools in your code. You will still need a Squad API key or JWT for authentication (see Quick start section above).
Example usage (Vercel AI):
import { generateText, tool } from 'ai';
import { tools as squadTools } from "@squadai/tools"
const result = await generateText({
model: yourModel,
tools: squadTools({
jwt: "JWT",
orgId: "orgId",
workspaceId: "workspaceId"
}),
prompt: 'What is the weather in San Francisco?',
});
âď¸ Integrating with an MCP client
Add a mcpServers entry to your clientâs configuration (e.g. claude_desktop_config.json or Cursor). Adjust command to match the installation method.
Using the standâalone executable
{
"mcpServers": {
"meet-squad": {
"command": "C:/path/to/squad-mcp.exe",
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
}
}
}
}
Using Docker
{
"mcpServers": {
"meet-squad": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "SQUAD_API_KEY",
"mcp/meet-squad"
],
"env": {
"SQUAD_API_KEY": "YOUR_API_KEY_HERE",
}
}
}
}
Prefer "command": "npx" if you installed via NPX.
Once your client restarts you should see the Squad tools (hammer đ¨ icon) listed and ready for use.
đ ď¸ Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
SQUAD_API_KEY | Yes | â | Personal access token generated in Squad |
SQUAD_ENV | No | production | Override the Squad API base URL (staging, development, âŚ) |
đ§âđť Development
npm install
npm run format
npm run openapi:squad # reâgenerate typed client from openapi/squad.json
npm run build
node dist/index.js
The test suite is workâinâprogress; contributions welcome.
