Squad AI

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.

This server cannot be installed

security - not tested

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Squad AI

Related MCP Servers

Linear MCP Server
ibraheem4
A
security
A
license
A
quality
Enables AI agents to manage issues, projects, and teams on the Linear platform programmatically.
Last updated -
7
83
50
JavaScript
MIT License
Crew AI MCP Server
MatthewLaw1
-
security
F
license
-
quality
Enables AI agent and task management using the CrewAI framework, allowing users to create and run agents and tasks in an automated workflow environment.
Last updated -
0
3
JavaScript
MCP Human Loop Server
boorich
A
security
F
license
A
quality
An intelligent middleware that determines when human intervention is necessary in AI agent operations using a sequential scoring system that evaluates multiple dimensions of a request.
Last updated -
1
6
TypeScript
MCP Unified Server
getfounded
-
security
A
license
-
quality
A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.
Last updated -
45
Python
MIT License

View all related MCP servers

Squad AI

Squad MCP Server

Why?

✨ Tools

🚀 Quick start

1 · Obtain a Squad API key

2 · Run the server

Option A – Stand‑alone executable (recommended for local usage)

Option B – Docker (recommended for production)

Option C – From source

📦 NPM Package (@squadai/tools)

⚙️ Integrating with an MCP client

Using the stand‑alone executable

Using Docker

🛠️ Environment variables

🧑‍💻 Development

Related MCP Servers

Linear MCP Server

Crew AI MCP Server

MCP Human Loop Server

MCP Unified Server

New MCP Servers

MCP directory API

Squad MCP Server

Why?

✨ Tools

🚀 Quick start

1 · Obtain a Squad API key

2 · Run the server

Option A – Stand‑alone executable (recommended for local usage)

Option B – Docker (recommended for production)

Option C – From source

📦 NPM Package (@squadai/tools)

⚙️ Integrating with an MCP client

Using the stand‑alone executable

Using Docker

🛠️ Environment variables

🧑‍💻 Development

Related MCP Servers

Linear MCP Server

Crew AI MCP Server

MCP Human Loop Server

MCP Unified Server

New MCP Servers

MCP directory API

Option A – Stand‑alone executable (recommended for local usage)

Option B – Docker (recommended for production)