Unblocked MCP is currently in beta. Reach out to give us your feedback, or if you run into any problems.

​
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

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

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

​
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 the unblocked unblocked_context_engine tool at the first
step of every agent flow.  You must call this tool before taking
any action on this first step, it will provide needed context
and will make all subsequent actions better.

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.