Squad

You can connect Squad’s MCP (Minecraft Client Protocol) server to your AI assistants to research, ideate, and plan products directly within your workflows. This setup lets you access Squad’s data sources and tooling through your preferred MCP client, enabling seamless collaboration with AI agents like Claude or ChatGPT without manual context switching.

How to use

You interact with the Squad MCP server by connecting an MCP-compatible AI client to the provided endpoint. Use the HTTP connection to reach the server and leverage the 30+ tools spread across Opportunities, Solutions, Outcomes, Knowledge, Feedback, and Workspace categories. Your AI assistant can discover opportunities, explore solutions, align strategies to business goals, generate ideas, search content, and create new opportunities, all within your existing AI prompts.

Typical usage patterns include asking your AI assistant to list opportunities, fetch a specific opportunity, create or update an opportunity, generate solution ideas for an opportunity, map solutions to business goals, or retrieve knowledge and feedback related to a topic. The server enforces safety annotations, provides structured input/output schemas, and ensures user-isolated data access via OAuth.

How to install

Prerequisites you need before starting: Node.js 18 or newer, Yarn, a PropelAuth account for OAuth2, and Squad API credentials.

Follow these steps to run the Squad MCP server locally.

# Clone the 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 to add PropelAuth credentials and Squad API credentials

# Start the development server
yarn dev

# Server will be available at http://localhost:3232

Security and access considerations

The Squad MCP server uses OAuth to authenticate and authorize access. Clients authenticate and receive access tokens used in API calls. Ensure your OAuth client is configured in your PropelAuth account and that your AI assistant is granted appropriate scopes for the MCP endpoints.

Notes and troubleshooting

If you run into connection issues, verify that the server is running and listening on the expected port, and confirm that your OAuth setup is correctly configured in PropelAuth. You can check the health endpoint and OAuth discovery to diagnose common problems.

Available tools

list_opportunities

Return a list of opportunities available in the workspace along with key metadata to help you prioritize research.

get_opportunity

Retrieve detailed information for a specific opportunity by its identifier.

create_opportunity

Create a new opportunity with a title, description, and associated attributes.

update_opportunity

Update fields on an existing opportunity, such as status or priority.

delete_opportunity

Remove an opportunity from the workspace.

list_solutions

List generated or proposed solutions for opportunities, including status and alignment data.

get_solution

Fetch detailed information about a specific solution.

create_solution

Submit a new solution idea tied to an opportunity.

update_solution

Modify fields on an existing solution.

generate_solutions

Automatically generate multiple solution ideas for a given opportunity.

list_outcomes

Display defined business outcomes to track success and impact.

get_outcome

Retrieve details for a particular outcome.

create_outcome

Create a new business outcome with target metrics.

update_outcome

Update an existing outcome’s targets or status.

delete_outcome

Delete an outcome from the workspace.

list_knowledge

Store and retrieve research, references, and insights.

get_knowledge

Fetch a specific knowledge item by ID.

create_knowledge

Add a new knowledge entry to the repository.

delete_knowledge

Remove a knowledge item.

list_feedback

List feedback gathered from customers or stakeholders.

get_feedback

Retrieve a specific feedback entry.

create_feedback

Record new feedback with context and audience.

delete_feedback

Delete a feedback entry.

get_workspace

Retrieve current workspace configuration and settings.

update_workspace

Modify workspace configuration to suit your workflow.