Unblocked MCP and agent skills

Unblocked gives coding agents organizational context from code, pull requests, docs, issues, and conversations. Unblocked MCP makes that context available through the Model Context Protocol. Agent skills teach agents when and how to use it.

This repository contains public connection documentation, MCP Registry metadata, and agent skills. It does not contain the hosted server's implementation. The skills follow the open Agent Skills specification.

Connect to hosted Unblocked MCP

You need an Unblocked account with access to your team's workspace. To set up Unblocked, first connect your source code. Then add data sources such as documentation, issue trackers, and messaging platforms to give your agents context beyond the code. Follow the MCP setup guide to connect your coding agent.

1. Add a remote MCP server in a client that supports Streamable HTTP and OAuth.
2. Set the server URL to https://getunblocked.com/api/mcpsse.
3. Select Streamable HTTP, sometimes shown as HTTP in the client.
4. Follow the client's OAuth prompt. Sign in to Unblocked and authorize the connection.

See the current remote connection instructions for client setup and authentication details.

MCP tools

The hosted MCP server exposes two tools:

MCP tool	Purpose
context_research	Research across code, pull requests, docs, issues, and conversations. Returns an answer with source citations.
context_get_urls	Retrieve content from one or more known URLs.

MCP tools, CLI commands, and skills are separate. The Unblocked CLI provides commands such as unblocked context-research and unblocked context-get-urls. It also provides context-search-* and context-query-* commands. Those extra commands are not hosted MCP tools. The skills below guide agents through these workflows.

Available skills

Skill	Description
unblocked-context-research	Research across connected sources using the CLI or MCP
unblocked-context-search-code	Search code across connected repositories using the CLI
unblocked-context-search-prs	Search pull request descriptions and reviews using the CLI
unblocked-context-search-issues	Search issue trackers using the CLI
unblocked-context-search-documentation	Search documentation using the CLI
unblocked-context-search-messages	Search team conversations using the CLI
unblocked-context-query-issues	Retrieve issues filtered by project and person using the CLI
unblocked-context-query-prs	Retrieve pull requests filtered by repository and person using the CLI
unblocked-context-get-urls	Retrieve URL content using the CLI or MCP
unblocked-tools-guide	Choose between CLI commands and MCP tools, and handle unavailable tools

Setup

Unblocked CLI installer

On macOS and Linux, this command installs the Unblocked CLI, configures supported coding agents, installs skills, and starts OAuth authentication:

curl -fsSL https://getunblocked.com/install-mcp.sh | bash

See the MCP setup guide for supported clients and platform instructions.

Claude plugin

Connect this repository as a plugin directly in Claude Code:

claude plugin marketplace add unblocked/skills
claude plugin install unblocked-skills

Using the Skills CLI

bunx skills add unblocked/skills

Manual copy

Copy the skill directory into your agent's skills folder. Replace <skill-name> with a directory such as unblocked-context-research or unblocked-context-get-urls:

# Claude Code
cp -r skills/<skill-name> ~/.claude/skills/

# Cursor
cp -r skills/<skill-name> .cursor/skills/

Documentation and support

• Unblocked MCP product overview
• Product documentation
• Contact Unblocked support