Summary
Connects Squad's product management platform to Claude or any MCP client via OAuth, exposing 30+ tools for managing opportunities, solutions, goals, feedback, and knowledge. You get full CRUD on each entity type, plus relationship management between them, semantic search across your workspace, and strategic views like OST mapping and roadmaps. The server mints JWTs from OAuth tokens and proxies requests to Squad's API with user isolation. Reach for this when you want to research product ideas, build roadmaps, or query customer insights without leaving your AI conversation. Authentication happens through PropelAuth with automatic OAuth discovery, and there's a companion NPM package if you want to use the tools programmatically in Node apps.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
40 tools
list_workspacesList all organisations and workspaces available to the current user. Use this to see what workspaces you can switch to.
List all organisations and workspaces available to the current user. Use this to see what workspaces you can switch to.
No parameter schema in public metadata yet.
select_workspaceSelect which organisation and workspace to use for subsequent operations. Required when user has access to multiple orgs/workspaces.2 params
Select which organisation and workspace to use for subsequent operations. Required when user has access to multiple orgs/workspaces.
Parameters* required
orgIdstringThe ID of the organisation to select
workspaceIdstringThe ID of the workspace to select
get_workspaceGet details of the current workspace. Workspaces contain the project name, detailed description, and mission statement.
Get details of the current workspace. Workspaces contain the project name, detailed description, and mission statement.
No parameter schema in public metadata yet.
update_workspaceUpdate the current workspace's details such as name, description, mission statement.5 params
Update the current workspace's details such as name, description, mission statement.
Parameters* required
namestringUpdated name for the workspace
logoUrlstringUpdated URL to the workspace's logo
descriptionstringUpdated detailed description of the workspace
homepageUrlstringUpdated URL to the workspace's homepage
missionStatementstringUpdated mission statement for the workspace
create_opportunityCreate a new opportunity. An opportunity is a detailed problem statement identified for the organisation. It doesn't have any solutionising and simply captures an opportunity for the organisation.2 params
Create a new opportunity. An opportunity is a detailed problem statement identified for the organisation. It doesn't have any solutionising and simply captures an opportunity for the organisation.
Parameters* required
titlestringA short title
descriptionstringA short description of the opportunity, detailing the problem statement and opportunity for the business
list_opportunitiesList all opportunities in the workspace. Opportunities are problem statements identified for the organisation.
List all opportunities in the workspace. Opportunities are problem statements identified for the organisation.
No parameter schema in public metadata yet.
get_opportunityGet details of a specific opportunity by ID. Opportunities are problem statements identified for the organisation.2 params
Get details of a specific opportunity by ID. Opportunities are problem statements identified for the organisation.
Parameters* required
opportunityIdstringThe ID of the opportunity to retrieve
relationshipsarrayRelationships to include in the response. Outcomes are business objectives/goals. Solutions are proposed approaches to address opportunities. Feedback is additional information or insights related to the opportunity.
update_opportunityUpdate an existing opportunity's details such as title, description, or status.4 params
Update an existing opportunity's details such as title, description, or status.
Parameters* required
titlestringUpdated title
statusstringUpdated status: New hasn't been developed, InProgress means we're currently building out solutions and implementing them. Planned means we've finished developing the solutions and are ready to implement them. Solved means we've completed the implementation and the opportunity is considered addressed.one of
New · Solved · Planned · InProgressdescriptionstringUpdated description
opportunityIdstringThe ID of the opportunity to update
delete_opportunityDelete an opportunity by ID.1 params
Delete an opportunity by ID.
Parameters* required
opportunityIdstringThe ID of the opportunity to delete
generate_solutionsStart the process of generating solutions for an opportunity. This will use Squad AI to generate new potential solutions for a given opportunity.2 params
Start the process of generating solutions for an opportunity. This will use Squad AI to generate new potential solutions for a given opportunity.
Parameters* required
promptstringOptional prompt to guide solution generation
opportunityIdstringThe ID of the opportunity to generate solutions for
manage_opportunity_relationshipsAdd or remove relationships between an opportunity and other entities (solutions, outcomes, or insights).5 params
Add or remove relationships between an opportunity and other entities (solutions, outcomes, or insights).
Parameters* required
actionstringWhether to add or remove the relationshipsone of
add · removeinsightIdsarrayIDs of insight items to relate to this opportunity
outcomeIdsarrayIDs of outcomes to relate to this opportunity
solutionIdsarrayIDs of solutions to relate to this opportunity
opportunityIdstringThe ID of the opportunity to manage relationships for
create_solutionCreate a new solution. A solution is a proposed approach to address an opportunity. The 'prd' field should contain the complete detailed specification, while 'description' should be a brief summary for AI context.6 params
Create a new solution. A solution is a proposed approach to address an opportunity. The 'prd' field should contain the complete detailed specification, while 'description' should be a brief summary for AI context.
Parameters* required
prdstringThe complete Product Requirements Document (PRD) containing the full detailed specification, implementation plan, and requirements for this solution. This is the primary content field.
consarrayList of cons/drawbacks of this solution. This is a sentence or two max.
prosarrayList of pros/benefits of this solution. This is a sentence or two max.
titlestringA short title for the solution
statusstringStatus of the solution: New hasn't been developed, InDevelopment means we're currently building out requirements and implementing them. Planned means we've finished developing the solutions and are ready to implement them. Complete means we've completed the implementation and the opportunity is considered addressed. Cancelled means we've cancelled the implementation and the opportunity is no longer considered addressed. Backlog means we've added this to the backlog and it will be worked on in the future.one of
New · InDevelopment · Planned · Complete · Cancelled · BacklogdescriptionstringA brief AI-friendly summary of the solution for context and search purposes. Keep this concise.
list_solutionsList all solutions in the workspace. Solutions are proposed approaches to address opportunities.2 params
List all solutions in the workspace. Solutions are proposed approaches to address opportunities.
Parameters* required
filterstringFilter solutions: 'roadmap' returns built solutions (user-created or edited), 'recommended' returns AI-generated suggestions not yet acted on. Omit to return all.one of
roadmap · recommendedhorizonstringFilter by time horizon: 'now' for current work, 'next' for upcoming, 'later' for future.one of
now · next · laterget_solutionGet details of a specific solution by ID.2 params
Get details of a specific solution by ID.
Parameters* required
solutionIdstringThe ID of the solution to retrieve
relationshipsarrayRelationships to include in the response. Opportunities are problem statements identified for the organisation. Outcomes are business objectives/goals. Feedback is additional information or insights related to the opportunity.
edit_solution_prdEdit the PRD (Product Requirements Document) of a solution. Use this to write or rewrite the detailed specification, implementation plan, and requirements for a solution.2 params
Edit the PRD (Product Requirements Document) of a solution. Use this to write or rewrite the detailed specification, implementation plan, and requirements for a solution.
Parameters* required
prdstringThe complete updated PRD content. This replaces the existing PRD entirely.
solutionIdstringThe ID of the solution to edit
update_solutionUpdate a solution's metadata (title, description, pros, cons, status, horizon). To edit the PRD content, use edit_solution_prd. To change priority, use prioritise_solutions. To move a solution between roadmap horizons, set the horizon field.8 params
Update a solution's metadata (title, description, pros, cons, status, horizon). To edit the PRD content, use edit_solution_prd. To change priority, use prioritise_solutions. To move a solution between roadmap horizons, set the horizon field.
Parameters* required
prdstringUpdated complete Product Requirements Document (PRD) containing the full detailed specification and implementation plan
consarrayUpdated list of cons/drawbacks
prosarrayUpdated list of pros/benefits
titlestringUpdated title
statusstringStatus of the solution: New hasn't been developed, InDevelopment means we're currently building out requirements and implementing them. Planned means we've finished developing the solutions and are ready to implement them. Complete means we've completed the implementation and the opportunity is considered addressed. Cancelled means we've cancelled the implementation and the opportunity is no longer considered addressed. Backlog means we've added this to the backlog and it will be worked on in the future.one of
New · InDevelopment · Planned · Complete · Cancelled · BackloghorizonstringRoadmap time horizon: 'now' for current work, 'next' for upcoming, 'later' for future.one of
now · next · latersolutionIdstringThe ID of the solution to update
descriptionstringUpdated brief AI-friendly summary for context and search purposes
delete_solutionDelete a solution by ID.1 params
Delete a solution by ID.
Parameters* required
solutionIdstringThe ID of the solution to delete
manage_solution_relationshipsAdd or remove relationships between a solution and other entities (opportunities).3 params
Add or remove relationships between a solution and other entities (opportunities).
Parameters* required
actionstringWhether to add or remove the relationshipsone of
add · removesolutionIdstringThe ID of the solution to manage relationships for
opportunityIdsarrayIDs of opportunities to relate to this solution
prioritise_solutionsReorder the priority of solutions by moving them before a specified solution. This is the only way to change solution priority/ordering in the workspace.2 params
Reorder the priority of solutions by moving them before a specified solution. This is the only way to change solution priority/ordering in the workspace.
Parameters* required
beforeIdvalueID of the solution before which to place the solutions, or null to place at the end
solutionIdsarrayList of solution IDs to move
create_goalCreate a new goal. A goal is a business objective that the organization aims to achieve.7 params
Create a new goal. A goal is a business objective that the organization aims to achieve.
Parameters* required
titlestringA short title for the goal
trendnumberTrend indicator for the goal (numeric)
ownerIdstringID of the goal owner
prioritynumberImportance level of the goal (1–5, higher = more important)
descriptionstringA detailed description of the goal
hideContentbooleanWhether the goal content should be hidden
analyticEventsarrayList of analytic events associated with the goal
list_goalsList all goals in the workspace. Goals are business objectives that the organization aims to achieve.
List all goals in the workspace. Goals are business objectives that the organization aims to achieve.
No parameter schema in public metadata yet.
get_goalGet details of a specific goal by ID. Goals are business objectives that the organization aims to achieve.2 params
Get details of a specific goal by ID. Goals are business objectives that the organization aims to achieve.
Parameters* required
goalIdstringThe ID of the goal to retrieve
relationshipsarrayRelationships to include in the response. Opportunities are problem statements identified for the organisation. Solutions are proposed approaches to address opportunities. Insights are additional information related to the opportunity.
update_goalUpdate an existing goal's details.8 params
Update an existing goal's details.
Parameters* required
titlestringUpdated title
trendnumberUpdated trend indicator
goalIdstringThe ID of the goal to update
ownerIdstringUpdated ID of the goal owner
prioritynumberUpdated importance level (1–5, higher = more important)
descriptionstringUpdated description
hideContentbooleanWhether the goal content should be hidden
analyticEventsarrayUpdated list of analytic events
delete_goalDelete a goal by ID.1 params
Delete a goal by ID.
Parameters* required
goalIdstringThe ID of the goal to delete
manage_goal_relationshipsAdd or remove relationships between a goal and opportunities for the business.3 params
Add or remove relationships between a goal and opportunities for the business.
Parameters* required
actionstringWhether to add or remove the relationshipsone of
add · removegoalIdstringThe ID of the goal to manage relationships for
opportunityIdsarrayIDs of opportunities to relate to this goal
create_knowledgeCreate a new knowledge entry. Knowledge entries are text documents that can be used as references or information sources.3 params
Create a new knowledge entry. Knowledge entries are text documents that can be used as references or information sources.
Parameters* required
titlestringA short title for the knowledge
contentstringThe full content of the knowledge
descriptionstringA short summary of the knowledge content
list_knowledgeList all knowledge entries in the workspace. Knowledge entries are text documents that can be used as references or information sources. List only shows the available items and a short description for the actual knowledge use the get by id call.
List all knowledge entries in the workspace. Knowledge entries are text documents that can be used as references or information sources. List only shows the available items and a short description for the actual knowledge use the get by id call.
No parameter schema in public metadata yet.
get_knowledgeGet details of a specific knowledge entry by ID. Knowledge entries are text documents that can be used as references or information sources.1 params
Get details of a specific knowledge entry by ID. Knowledge entries are text documents that can be used as references or information sources.
Parameters* required
knowledgeIdstringThe ID of the knowledge entry to retrieve
delete_knowledgeDelete a knowledge entry by ID.1 params
Delete a knowledge entry by ID.
Parameters* required
knowledgeIdstringThe ID of the knowledge entry to delete
create_feedbackCreate a new feedback entry. Feedback represents raw, unprocessed feedback from users that can later be analyzed and converted into insights.5 params
Create a new feedback entry. Feedback represents raw, unprocessed feedback from users that can later be analyzed and converted into insights.
Parameters* required
sourcestringThe source of the feedback (e.g., 'Typeform', 'Slack', 'Manual', 'Email', etc.)
contentstringThe original raw feedback content from the user
sentimentScorenumberSentiment score from -1 (negative) to 1 (positive)
sentimentCategorystringSentiment classification category: 'Positive', 'Neutral', or 'Negative'one of
Positive · Neutral · NegativesentimentConfidencenumberConfidence in sentiment analysis (0-1)
list_feedbackList all feedback entries in the workspace. Feedback entries are raw customer feedback that can be processed into insights.
List all feedback entries in the workspace. Feedback entries are raw customer feedback that can be processed into insights.
No parameter schema in public metadata yet.
get_feedbackGet details of a specific feedback entry by ID. Feedback entries are raw customer feedback.2 params
Get details of a specific feedback entry by ID. Feedback entries are raw customer feedback.
Parameters* required
feedbackIdstringThe ID of the feedback entry to retrieve
relationshipsstringShow insights that were generated from this feedback.one of
insightsdelete_feedbackDelete a feedback entry by ID.1 params
Delete a feedback entry by ID.
Parameters* required
feedbackIdstringThe ID of the feedback entry to delete
create_insightCreate a new insight entry. An insight is customer-generated feedback about your product, often from reviews, surveys, or questionnaires.3 params
Create a new insight entry. An insight is customer-generated feedback about your product, often from reviews, surveys, or questionnaires.
Parameters* required
typestringThe type of insight: 'Feedback' for customer feedback, 'Bug' for bug reports, or 'FeatureRequest' for feature requests.one of
Feedback · Bug · FeatureRequesttitlestringA brief title summarizing the insight
descriptionstringA short description of the insight
list_insightsList all insights for the workspace. These insights are gathered from various sources, created by customers, and help understand how to improve the business.
List all insights for the workspace. These insights are gathered from various sources, created by customers, and help understand how to improve the business.
No parameter schema in public metadata yet.
get_insightGet details of a specific insight entry by ID. Insight entries are text documents that can be used as references or information sources.2 params
Get details of a specific insight entry by ID. Insight entries are text documents that can be used as references or information sources.
Parameters* required
insightIdstringThe ID of the insight entry to retrieve
relationshipsarrayShow other entities that this insight is related to.
delete_insightDelete an insight entry by ID.1 params
Delete an insight entry by ID.
Parameters* required
insightIdstringThe ID of the insight entry to delete
similarity_searchPerform a semantic similarity search across the workspace. This searches through knowledge documents, feedback insights, opportunities, and solutions to find content similar to your query. Each result will contain a nodeId or an id. These can be used to retrieve the full conte...2 params
Perform a semantic similarity search across the workspace. This searches through knowledge documents, feedback insights, opportunities, and solutions to find content similar to your query. Each result will contain a nodeId or an id. These can be used to retrieve the full conte...
Parameters* required
querystringThe search query string
filtersarrayFilters to apply to the search. Options are: knowledge-base for knowledge documents, insights for insights, opportunities for opportunities, solutions for solutions.
view_strategy_contextShow an entity in its product strategy tree — displays the entity, its parent chain, and direct children in a rich visual UI. ALWAYS use this tool when the user asks about strategy, prioritisation, reasoning, context, positioning, or 'why' behind any entity. Use it when the us...2 params
Show an entity in its product strategy tree — displays the entity, its parent chain, and direct children in a rich visual UI. ALWAYS use this tool when the user asks about strategy, prioritisation, reasoning, context, positioning, or 'why' behind any entity. Use it when the us...
Parameters* required
entityIdstringThe ID of the entity to view. Not required for workspace (uses current workspace).
entityTypestringThe type of entity to viewone of
workspace · goal · opportunity · solution · insight · feedbackview_roadmapShow the product roadmap — solutions organized by time horizon (Now/Next/Later) with goal context. Use this when the user asks about the roadmap, what's planned, what's coming next, priorities, or wants to see an overview of solutions being built.3 params
Show the product roadmap — solutions organized by time horizon (Now/Next/Later) with goal context. Use this when the user asks about the roadmap, what's planned, what's coming next, priorities, or wants to see an overview of solutions being built.
Parameters* required
goalIdstringFilter to solutions linked to this goal
showResolvedbooleanInclude completed/cancelled solutionsdefault: false
statusFilterarrayFilter by solution statuses
Squad MCP Server
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.
🚀 Quick Start
For Users
Connect Squad to your AI assistant in seconds:
Claude Code:
claude mcp add --transport http squad https://mcp.meetsquad.ai/mcp
On first use, you'll be prompted to authenticate via OAuth in your browser.
Claude Connectors:
- Coming soon to the Claude MCP directory
ChatGPT:
- Coming soon to the ChatGPT plugin store
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.
📖 Usage Examples
See USAGE_EXAMPLES.md for detailed real-world examples including:
- Discover opportunities - "What opportunities are in my workspace?"
- Explore solutions - "Show me solutions for [opportunity] with pros/cons"
- Strategic alignment - "How do my solutions map to business goals?" (OST view)
- Generate ideas - "Generate solution ideas for [opportunity]"
- Search everything - "Find all content related to compliance"
- Create opportunities - "Create a new opportunity for [customer pain point]"
Each example shows the actual user prompt, which tools get called behind the scenes, and the expected output based on real Squad data.
✨ Available Tools
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 |
Tool Capabilities
All tools include:
- ✅ Safety annotations (
readOnlyHint/destructiveHint) - ✅ Structured JSON schemas for inputs/outputs
- ✅ User-isolated data access via OAuth
- ✅ Relationship management between entities
🏗️ Architecture
┌─────────────┐ 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 │
└──────────────┘
📦 NPM Package
For programmatic access to Squad tools in your Node.js applications:
npm install @squadai/tools
import { 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",
});
🛠️ Development
This repository contains the source code for the Squad MCP remote server.
Prerequisites
- Node.js 22.22+
- Yarn
- Nix (optional, for reproducible dev environment via
flake.nix) - PropelAuth account (for OAuth2)
- Squad API credentials
Local Setup
# 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:3232
Available Commands
yarn 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
Testing the Server
# 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/mcp
Project Structure
squad-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 template
🏭 Production Deployment
This is a hosted service maintained by Squad. Users connect via OAuth - no self-hosting required.
Architecture Notes (for contributors):
- Single-instance deployment on Railway
- Follows MCP specification for stateful HTTP sessions
- In-memory transport storage (standard per MCP spec)
💬 Support
Need help with the Squad MCP server?
- Email: support@meetsquad.ai
- Documentation:
- Squad MCP Guide - Complete setup and integration guide
- USAGE_EXAMPLES.md - Real-world usage examples
- Issues: GitHub Issues - Bug reports and feature requests
- Privacy Policy: meetsquad.ai/privacy-policy
- Squad Platform: meetsquad.ai - Learn about Opportunity Solution Trees
🤝 Contributing
Contributions welcome! Pre-commit hooks run biome lint and vitest automatically. Please ensure:
yarn formatpasses (biome lint)yarn buildcompiles without errorsyarn testpasses- All tools include safety annotations
📄 License
MIT
🔗 Links
- Squad MCP Documentation - Complete setup and integration guide
- Squad Platform
- MCP Specification
- Claude Desktop
- Issue Tracker
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →