Overview

Unblocked MCP is a set of MCP tools that enhance existing agentic applications with the context and knowledge of Unblocked. Existing agentic apps work well for many operations, especially those that are constrained — for instance, greenfield work, building or enhancing individual isolated components, and writing unit tests. Often agentic apps will do more poorly on larger tasks — for instance, editing code across different modules, or composing new modules that integrate with your company’s bespoke code. Also, sometimes the solutions to problems or the steps leading to implementation of new features are discussed outside of your codebase in places like Slack or Confluence. Without this critical context it’s often impossible for coding agents to make meaningful progress. Unblocked MCP can improve the output of many of these more complicated agentic interactions, by providing additional context to the agent engine, and helping guide it to better solutions.

Installation (MacOS)

You can install Unblocked MCP through the Unblocked Mac App:
  1. Open the Unblocked Mac App
  2. Open up the top-right menu
  3. Select Install IDE Plugins
mac-app-install-ide-plugins This will install Unblocked MCP into the following apps:
  • Cursor
  • VSCode Copilot
  • Windsurf
  • Claude Desktop
  • Claude Code
Let us know if there is a different agentic app you would like to use Unblocked MCP with.
If you would like to install Unblocked MCP manually, you can use the following values:Binary:
/Users/<name>/.unblocked/agent/node/bin/node
Arguments:
/Applications/Unblocked.app/Contents/Resources/mcp/server.js

Installation (Windows & Linux)

On Windows and Linux, you can install Unblocked MCP manually using the streamable HTTP URL https://getunblocked.com/api/mcpsse:
Click here to install Unblocked MCP into Cursor.If you’d like to install Unblocked MCP manually, you can edit your ~/.cursor/mcp.json file as follows:
{
  "mcpServers": {
    "unblocked": {
      "url": "https://getunblocked.com/api/mcpsse"
    }
  }
}
After installing Unblocked MCP into Cursor, you will need to log in to Unblocked. In Cursor’s Tools & Integrations page, the unblocked tools may be shown with a Needs login label. Click on the Needs login to log in to Unblocked.

Installation (Headless Automation)

You can install Unblocked MCP for use in headless automation scenarios, such as within GitHub Actions.
1

Create the API Token

Click on Settings —> API Tokens.Click on Create Token, fill out the token name, and click the Create Token button.MCP Token[]
2

Copy the API Token

Copy the resulting API token. MCP Token[]
This API token gives access to every document in your Unblocked team’s data sources. If your team has connected sensitive data, such as private Slack channels, the MCP tools will potentially return this data in its queries.A future version of MCP for Unblocked will allow specifying which data sources the MCP tools will be given access to.
3

Install Unblocked MCP

In your automation system, configure the Unblocked MCP tools:
You can install the tools into Claude Code with the following command:
claude mcp add -s user --transport http secure-server https://getunblocked.com/api/mcpsse --header "Authorization: Bearer unb_token"
or by editing the ~/.claude.json file:
{
  "mcpServers": {
    "unblocked": {
      "type": "http",
      "url": "https://getunblocked.com/api/mcpsse",
      "headers": {
        "Authorization": "Bearer unb_token"
      }
    }
  }
}
Be sure to replace unb_token with the token you generated above.

Usage

To use Unblocked MCP, ask your agent app to ask Unblocked when you perform your operation:
Create a class that connects with the FooBar component and produces log output, ask Unblocked first
The agent will first ask Unblocked to provide more information, and then will use it to output a solution. Depending on which agent is orchestrating the work, Unblocked may be invoked multiple times, to provide different kinds of context, and the output may be summarized in a work plan for you to approve. You can also ask Unblocked directly for information about highlighted code or a module:
Why did we do this? Ask Unblocked first.
We recommend configuring your agentic app to automatically invoke Unblocked:
You can configure Cursor Rules to invoke Unblocked MCP automatically:
  • Open Cursor —> Settings —> Cursor Settings —> Rules
  • Under User Rules, add:
Call unblocked_context_engine at every step to gather context.
Make sure you call unblocked_context_engine before you call any
of your own tools as well. When you call Unblocked tools be sure
to pass one of either the repoUrl, projectPath, or filePath
parameters, preferrably the projectPath

Let us know if you find other rules that work particularly well!

We are actively investigating having the Unblocked MCP tools invoke automatically for future versions of the MCP tools, for all agentic apps.