Which integrations are available for this server?

Provides the @squadai/tools NPM package for Node.js applications, enabling programmatic interaction with Squad API for product management tasks Supports Vercel AI SDK integration through the @squadai/tools package, enabling Squad's product management capabilities within Vercel AI applications

How do I use Squad AI?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Squad AI list opportunities for our mobile app project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.

Related MCP server: Algolia

📖 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 6 categories:

Category	Tools	Purpose
Opportunities	`list_opportunities`, `get_opportunity`, `create_opportunity`, `update_opportunity`, `delete_opportunity`	Discover and refine product opportunities
Solutions	`list_solutions`, `get_solution`, `create_solution`, `update_solution`, `generate_solutions`	Generate and iterate on solution ideas
Outcomes	`list_outcomes`, `get_outcome`, `create_outcome`, `update_outcome`	Define and track desired business outcomes
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
Workspace	`get_workspace`, `update_workspace`	Configure workspace settings

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 │ │ │ │ Session Store → Manage State │ │ │ │ MCP Handler → Execute Tools │ │ │ └────────────────────────────────────────┘ │ └──────────────────────────────────────────────┘ │ │ Squad API Calls ▼ ┌──────────────┐ │ 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 18+
Yarn
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 openapi:squad # Regenerate API client from OpenAPI spec yarn test # Run test suite

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

Running Tests

# Setup environment (if not already done) cp .env.example .env # Edit .env with your PropelAuth credentials and Squad API key # Run tests yarn test

Note: Tests use SQUAD_API_KEY from .env for authentication (not OAuth).

Project Structure

squad-mcp/ ├── src/ │ ├── server.ts # MCP server with OAuth │ ├── middleware/ │ │ └── csp.ts # Content Security Policy │ ├── helpers/ │ │ └── config.ts # Environment configuration │ ├── lib/ │ │ └── clients/ # Squad API client │ └── tools/ # Tool implementations │ ├── opportunity.ts │ ├── solution.ts │ ├── goal.ts │ └── ... ├── 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! Please ensure:

TypeScript builds without errors (yarn build)
All tools include safety annotations
OAuth context properly propagated
Tests pass (when test suite is implemented)

📄 License

MIT

🔗 Links

Squad MCP Documentation - Complete setup and integration guide
Squad Platform
MCP Specification
Claude Desktop
Issue Tracker

Squad AI