Your AI Product Manager. Surface insights, build roadmaps, and plan strategy with 30+ tools.
A remote MCP server that brings Squad — the AI-powered product discovery and strategy platform — directly into your AI workflows. Connect Squad to Claude, ChatGPT, or any MCP-compatible AI assistant to research, ideate, and plan products without context switching.
Connect Squad to your AI assistant in seconds:
Claude Code:
claude mcp add --transport http squad https://mcp.meetsquad.ai/mcpOn first use, you'll be prompted to authenticate via OAuth in your browser.
Claude Connectors:
ChatGPT:
Other MCP Clients:
Connect using https://mcp.meetsquad.ai/mcp - OAuth configuration is automatically discovered via the server's .well-known/oauth-authorization-server endpoint.
See USAGE_EXAMPLES.md for detailed real-world examples including:
Each example shows the actual user prompt, which tools get called behind the scenes, and the expected output based on real Squad data.
The Squad MCP server provides 30+ tools across 9 categories:
| Category | Tools | Purpose |
|---|---|---|
| Opportunities | list_opportunities, get_opportunity, create_opportunity, update_opportunity, delete_opportunity, generate_solutions, manage_opportunity_relationships | Discover and refine product opportunities |
| Solutions | list_solutions, get_solution, create_solution, update_solution, delete_solution, manage_solution_relationships, prioritise_solutions | Generate and iterate on solution ideas |
| Goals | list_goals, get_goal, create_goal, update_goal, delete_goal, manage_goal_relationships | Define and track business objectives |
| Knowledge | list_knowledge, get_knowledge, create_knowledge, delete_knowledge | Store research, references, and insights |
| Feedback | list_feedback, get_feedback, create_feedback, delete_feedback | Manage customer and stakeholder feedback |
| Insights | list_insights, get_insight, create_insight, delete_insight | Track customer insights and feature requests |
| Workspace | list_workspaces, select_workspace, get_workspace, update_workspace | Configure workspace settings |
| Search | similarity_search | Semantic search across all entities |
| Views | view_strategy_context, view_roadmap | Rich visual strategy and roadmap widgets |
All tools include:
readOnlyHint / destructiveHint)┌─────────────┐ OAuth ┌──────────────┐
│ Claude / │ ◄────────────────────► │ PropelAuth │
│ ChatGPT │ (Authentication) │ (IdP) │
└─────────────┘ └──────────────┘
│
│ HTTPS + Bearer Token
▼
┌──────────────────────────────────────────────┐
│ Squad MCP Server │
│ ┌────────────────────────────────────────┐ │
│ │ OAuth Middleware → Validate Token │ │
│ │ JWT Minting → Service Credentials │ │
│ │ Session Store → Manage State │ │
│ │ MCP Handler → Execute Tools │ │
│ └────────────────────────────────────────┘ │
└──────────────────────────────────────────────┘
│
│ Squad API Calls (minted JWT)
▼
┌──────────────┐
│ Squad API │
└──────────────┘For programmatic access to Squad tools in your Node.js applications:
npm install @squadai/toolsimport { tools as squadTools } from "@squadai/tools";
// Use with Vercel AI SDK
const result = await generateText({
model: anthropic("claude-3-5-sonnet-20241022"),
tools: squadTools({
jwt: "YOUR_JWT_TOKEN",
orgId: "org-123",
workspaceId: "ws-456",
}),
prompt: "List my current product opportunities",
});This repository contains the source code for the Squad MCP remote server.
flake.nix)# Clone repository
git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
# Install dependencies
yarn install
# Configure environment
cp .env.example .env
# Edit .env with your PropelAuth credentials
# Start development server with hot reload
yarn dev
# Server available at http://localhost:3232yarn build # Compile TypeScript
yarn dev # Start dev server with hot reload
yarn start # Start production server
yarn test # Run unit tests (vitest)
yarn format # Lint with biome
yarn format:fix # Auto-fix lint issues
yarn openapi:squad # Regenerate API client from OpenAPI spec
yarn storybook # Run Storybook for widget development# Check health
curl http://localhost:3232/health
# Check OAuth discovery
curl http://localhost:3232/.well-known/oauth-authorization-server
# Test with MCP Inspector
npx @modelcontextprotocol/inspector
# Then connect to http://localhost:3232/mcpsquad-mcp/
├── index.ts # MCP server entry point with OAuth
├── server.json # MCP registry metadata
├── src/
│ ├── client.ts # MCP client export
│ ├── helpers/
│ │ ├── config.ts # Environment configuration
│ │ ├── getUser.ts # OAuth context + workspace selection
│ │ └── mintToken.ts # JWT minting + per-user cache
│ ├── lib/
│ │ ├── logger.ts # Structured logging
│ │ └── clients/
│ │ ├── squad.ts # Squad API client factory
│ │ └── middleware/ # Bearer token middleware
│ └── tools/ # Tool implementations
│ ├── opportunity.ts
│ ├── solution.ts
│ ├── goal.ts
│ ├── knowledge.ts
│ ├── feedback.ts
│ ├── insight.ts
│ ├── workspace.ts
│ ├── search.ts
│ ├── views.ts
│ └── helpers.ts
├── resources/ # React widget components
│ ├── view-strategy-context/
│ └── view-roadmap/
├── railway.toml # Railway deployment config
└── .env.example # Environment templateThis is a hosted service maintained by Squad. Users connect via OAuth - no self-hosting required.
Architecture Notes (for contributors):
Need help with the Squad MCP server?
Contributions welcome! Pre-commit hooks run biome lint and vitest automatically. Please ensure:
yarn format passes (biome lint)yarn build compiles without errorsyarn test passesMIT