MCP Server | Agent Shelf

hub

MCP Server

Connect your AI tools to AgentShelf via the Model Context Protocol. Search, discover, and download agents directly from your AI assistant.

updateLast updated: April 7, 2026

Overview

The AgentShelf MCP server lets any MCP-compatible AI tool search and discover agents from the registry. Instead of switching to the browser, your AI assistant can find the right agent for the task at hand, read its documentation, and download it — all within your coding environment.

Find agents by keyword, category, or tag

visibility

Discover

Browse featured and popular agents

download

Download

Get agent markdown to use locally

Remote Access

bolt

No installation required

AgentShelf hosts the MCP server for you. Just add the URL to your AI tool's config — no download, no build step.

Add the following to your AI tool's MCP configuration to connect directly to the hosted AgentShelf MCP server:

{
  "mcpServers": {
    "agentshelf": {
      "type": "http",
      "url": "https://www.agentshelf.dev/api/mcp"
    }
  }
}

Claude Code / Claude Desktop

Add to .mcp.json or claude_desktop_config.json

Cursor / Windsurf / Others

Add to your tool's MCP config file. See the Setup by Tool section below.

Remote access uses the Streamable HTTP transport. All tools are read-only — no authentication required for search and discovery.

Local Installation

Download the MCP server, install dependencies, and build it.

downloadDownload MCP Server (.zip)

Install and build:

# Unzip and install
unzip agentshelf-mcp-server.zip
cd agentshelf-mcp-server
npm install
npm run build

Requirements: Node.js 18+ and npm. The server communicates over stdio — no ports or network configuration needed.

Setup by Tool

Add the MCP server to your AI tool's configuration file. Pick your tool below:

Config file:.mcp.json

Location:Project root or ~/

{
  "mcpServers": {
    "agentshelf": {
      "type": "http",
      "url": "https://www.agentshelf.dev/api/mcp"
    }
  }
}

Important notes:

arrow_forwardReplace the path in args with the actual location where you unzipped the server
arrow_forwardSet AGENTSHELF_URL to your AgentShelf instance URL
arrow_forwardRestart your AI tool after updating the config

Examples

Once connected, your AI assistant can use AgentShelf tools automatically. Here are some things you can ask:

chat

“Find me a code review agent”

search_agents

Searches for agents matching "code review" and shows paginated results with downloads, likes, and descriptions.

chat

“What DevOps agents has alice published?”

search_agents

Filters by category and author simultaneously to find specific agents.

chat

“Show me the top 10 most downloaded agents”

search_agents

Sorts by downloads in descending order with a limit of 10.

chat

“Show me the most popular agents”

get_featured

Returns the top featured agents sorted by popularity.

chat

“Get version 1.0.0 of alice's code-reviewer agent”

get_agent

Fetches the specific version's content and metadata, with full version history.

chat

“Download the code-reviewer agent by alice”

download_agent

Downloads the full markdown with frontmatter, ready to use locally.

chat

“What categories of agents are there?”

list_categories

Lists all 14 categories with descriptions to help you find what you need.

Available Tools

Search Agents

search_agents

Search the registry by keyword, category, tag, or author. Supports sorting, direction control, and pagination.

Parameter	Type	Description
query	string?	Free-text search across name, description, tags, and author
category	string?	Filter by category
tag	string?	Filter by a specific tag
author	string?	Filter by author's GitHub username
sort	string?	downloads \| likes \| name \| createdAt (default: createdAt)
direction	string?	asc \| desc (default: desc)
limit	number?	Max results, 1-50 (default: 10)
skip	number?	Results to skip for pagination (default: 0)

info

Get Agent Details

get_agent

Get full details about a specific agent including markdown content, version history, and metadata. Optionally fetch a specific version.

Parameter	Type	Description
username	string	Author's GitHub username
name	string	Agent slug ID
version	string?	Specific version to retrieve (e.g. '1.0.0'). Omit for latest.

List Categories

list_categories

List all 14 valid agent categories with descriptions. Useful for filtering searches or categorizing new agents.

star

Get Featured Agents

get_featured

Get the top featured agents, sorted by popularity.

Parameter	Type	Description
limit	number?	Max results, 1-20 (default: 6)

download

Download Agent

download_agent

Download the raw markdown content of an agent. Optionally download a specific version.

Parameter	Type	Description
username	string	Author's GitHub username
name	string	Agent slug ID
version	string?	Specific version to download (e.g. '1.0.0'). Omit for latest.

Troubleshooting

Issue	Fix
Server not showing in tool	Check the path in `args` points to `build/index.js`. Make sure you ran `npm run build` first. Restart your AI tool.
Connection errors	Verify `AGENTSHELF_URL` is correct and the AgentShelf instance is running.
No results from search	Check that agents have been published on the registry. Try a broader search or use `get_featured` to see if any agents exist.
Node.js version error	Requires Node.js 18 or higher. Check with `node --version`.