Squad

Install

Config snippet generator goes here (5 client tabs)

README

# Squad MCP Server

A remote MCP server that brings [Squad](https://meetsquad.ai) — 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:**

```bash
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](./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           │  │
│  └────────────────────────────────────────┘  │
└─