MCP Setup

Installation

The Loop MCP server runs via npx and requires no global installation. You configure it in your AI tool's MCP settings.

Step 1: Generate an API token

1. Open your Loop dashboard
2. Go to Settings > Developer API
3. Click Generate token
4. Copy the token (starts with tok_)

Step 2: Add MCP configuration

Choose your AI tool below and add the Loop MCP server to its configuration.

Cursor

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "loop-feedback": {
      "command": "npx",
      "args": ["-y", "@loop-feedback/mcp"],
      "env": {
        "LOOP_API_TOKEN": "tok_your_token_here",
        "LOOP_API_URL": "https://loop.solve-studio.co"
      }
    }
  }
}

Claude Code

Run from your terminal:

claude mcp add loop-feedback \
  -e LOOP_API_TOKEN=tok_your_token_here \
  -e LOOP_API_URL=https://loop.solve-studio.co \
  -- npx -y @loop-feedback/mcp

Claude Desktop

Edit claude_desktop_config.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "loop-feedback": {
      "command": "npx",
      "args": ["-y", "@loop-feedback/mcp"],
      "env": {
        "LOOP_API_TOKEN": "tok_your_token_here",
        "LOOP_API_URL": "https://loop.solve-studio.co"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration (.windsurf/mcp.json or via Settings > MCP):

{
  "mcpServers": {
    "loop-feedback": {
      "command": "npx",
      "args": ["-y", "@loop-feedback/mcp"],
      "env": {
        "LOOP_API_TOKEN": "tok_your_token_here",
        "LOOP_API_URL": "https://loop.solve-studio.co"
      }
    }
  }
}

Other MCP clients

The Loop MCP server uses stdio transport, which is supported by all MCP clients. The configuration is the same across tools:

• Command: npx
• Args: ["-y", "@loop-feedback/mcp"]
• Environment: LOOP_API_TOKEN (required), LOOP_API_URL (optional)

Refer to your tool's documentation for where to add MCP server configuration.

Replace tok_your_token_here with your actual API token in all examples above.

Step 3: Restart your tool

After saving the configuration, restart your AI tool. The Loop MCP server will appear in your available tools.

Environment variables

Verifying the connection

Once configured, ask your AI assistant:

"List my Loop projects"

If the connection is working, it will use the list_projects tool and display your projects.

Troubleshooting

"LOOP_API_TOKEN environment variable is required"

The MCP server exits if no token is provided. Check that your MCP configuration includes the LOOP_API_TOKEN in the environment variables.

"Invalid or revoked token"

Your token may have been revoked. Generate a new one from Settings > Developer API and update your configuration.

"Developer API requires a Pro or Business plan"

API access is only available on Pro and Business plans. Check your plan in Settings > Billing or start a trial.

Server not appearing

• Ensure the configuration file is saved in the correct location for your tool
• Restart your AI tool after editing the configuration
• Check that Node.js 18+ is installed (node --version)