Squads

Squads MCP provides a secure Model Context Protocol (MCP) implementation for managing Solana multisig accounts. It emphasizes local key security, clear role separation, and auditable operations, enabling safe interaction between AI agents and multisig configurations while protecting assets.

How to use

You interact with the server through an MCP client that communicates with the Squads MCP toolset. Use the client to configure multisig accounts, create and vote on proposals, audit security, and execute approved transactions. The system enforces separate roles for initiating, voting, and executing actions, and supports time-locked operations to reduce risk.

How to install

Prerequisites: install Node.js 16 or higher, ensure you have Solana CLI tools if you plan to interact with the Solana network, and prepare a Solana wallet for production use.

# Using npm (recommended)
npm install squads-mcp

# Using yarn
yarn add squads-mcp

# Using pnpm
pnpm add squads-mcp

Configuration for the MCP client

Configure your client to run the Squads MCP server locally. The following example shows how to wire the MCP in a desktop configuration file.

{
  "mcpServers": {
    "squads_mcp": {
      "command": "node",
      "args": [
        "node_modules/squads-mcp/dist/index.js"
      ]
    }
  }
}

Additional sections

Security-first design and practical usage details are integrated to help you operate confidently with Squads MCP. You can audit multisig configurations, manage proposals, and perform vault transactions with explicit safeguards and clear separation of duties.

Security and best practices

• Separate INITIATE, EXECUTE, and VOTE roles to avoid single-point compromise.

• Use proper thresholds tailored to multisig type (e.g., Reserve, Operations, Upgrades) to balance security and usability.

• Enable time locks to enforce waiting periods before sensitive actions execute.

• Verify addresses before operations and perform critical actions on secure devices.

Tools and capabilities (high level)

This system provides tools for multisig management, proposal handling, transaction execution, and asset management, along with an enterprise-grade security audit capability.

Troubleshooting and notes

If you encounter issues starting the MCP server, ensure Node.js is accessible and the path to the Squads MCP entry point exists after installation. Re-check your configuration file for any typos in the command or arguments.

Available tools

CONNECTION_UPDATE

Configure the Solana connection used by the MCP client to target a specific cluster or RPC endpoint.

SHOW_CONFIG

Display the current MCP client configuration to verify connection settings and enabled tools.

CREATE_SQUADS_MULTISIG

Create a new Multisig account with customizable signers, thresholds, and permissions.

IMPORT_SQUADS_MULTISIG

Import an existing Multisig account into the MCP workflow for management and auditing.

GET_MULTISIG_ACCOUNT

View details of a multisig account, including members, thresholds, and current state.

AUDIT_MULTISIG_SECURITY

Run a security audit with recommendations, scoring, and risk categorization for multisig configurations.

CREATE_PROPOSAL

Create a new proposal for multisig actions (e.g., transfers, upgrades) and attach necessary metadata.

APPROVE_PROPOSAL

Cast a vote to approve a proposal, contributing to its execution path.

REJECT_PROPOSAL

Cast a vote to reject a proposal and halt its progress.

CANCEL_PROPOSAL

Cancel a pending proposal before execution to prevent unintended actions.

GET_PROPOSAL

Retrieve details about a specific proposal, including votes and status.

GET_PROPOSALS

List all proposals associated with a multisig account.

EXECUTE_CONFIG_TRANSACTION

Execute configuration changes for the multisig or its environment.

EXECUTE_VAULT_TRANSACTION

Execute vault-related transactions approved by the multisig.

GET_ASSETS

Query balances and assets held within a multisig vault.

FUND_VAULT

Fund a multisig vault with SOL or tokens to support operations.

TRANSFER_SOL_FROM_VAULT

Transfer SOL from a multisig vault to another account or destination.