Agent Registry

v1.0.0Developer Toolsstable

Fast-track AI innovation with a centralized, trusted, curated registry

agentsaimcpregistryskills
Share:
314
Stars
0
Downloads
0
Weekly
0/5

What is Agent Registry?

Agent Registry is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to fast-track ai innovation with a centralized, trusted, curated registry

Fast-track AI innovation with a centralized, trusted, curated registry

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Fast-track AI innovation with a centralized, trusted, curate

Use Cases

Centralized agent and skill registry
Trusted agent discovery
Agent ecosystem management
LicenseApache-2.0
Languagego
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx agentregistry

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Agent Registry

AgentRegistry is a centralized, curated registry for AI agents, MCP servers, skills, and reusable prompt templates that provides a trusted discovery and deployment layer for enterprise AI ecosystems. It supports registering MCP servers from npm, PyPI, OCI/Docker, or HTTP/SSE endpoints, and ships with a CLI tool (arctl), a local web UI, a REST API, and Kubernetes/Helm support for team-scale deployments. Teams use it to maintain a governed catalog of approved agents and capabilities, auto-generate client configurations for Claude Desktop, Cursor, and VS Code, and manage the full lifecycle of their agent infrastructure.

Prerequisites

  • Docker Desktop with Docker Compose v2+ installed (required for the registry backend)
  • curl available for the installer script
  • An MCP-compatible client such as Claude Desktop or Cursor to consume registered servers
  • Internet access to reach the AgentRegistry package sources during setup
1

Install the arctl CLI

Run the official installer script which downloads the arctl binary for your platform and adds it to your PATH.

curl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/get-arctl | bash
2

Verify the installation

Confirm that arctl is installed and accessible by checking the version.

arctl version
3

Start the AgentRegistry daemon

Start the local registry service using Docker Compose. The registry will be available at localhost:12121 and the web UI will open in your browser.

arctl start
4

Register an MCP server

Add an MCP server to your registry from an npm package, specifying its name and source. Registered servers are catalogued with metadata and can be deployed to clients with a single command.

arctl register mcp-server \
  --name my-server \
  --source npm:my-mcp-package
5

Generate client configuration

Once servers are registered, generate a ready-to-use config file for Claude Desktop, Cursor, or VS Code. This command outputs the correct JSON structure for your chosen client.

arctl generate-config --client claude-desktop
6

Browse the registry web UI

Open the local registry web interface to explore, search, and manage registered agents, skills, and MCP servers visually.

open http://localhost:12121

Agent Registry Examples

Client configuration

Example Claude Desktop configuration pointing to a server managed by AgentRegistry.

{
  "mcpServers": {
    "agentregistry": {
      "command": "npx",
      "args": ["agentregistry"]
    }
  }
}

Prompts to try

Example prompts for working with the AgentRegistry MCP interface.

- "List all registered MCP servers in the registry"
- "Find agents that have database access capabilities"
- "Show me the skills registered for code review workflows"
- "Generate a Claude Desktop config that includes all approved MCP servers"

Troubleshooting Agent Registry

arctl start fails because Docker is not running

Open Docker Desktop and wait for it to fully start (the whale icon in the taskbar/menu bar should stop animating). Then re-run 'arctl start'. The registry requires Docker Compose v2+, so also verify with 'docker compose version'.

Web UI at localhost:12121 is not accessible

Check that the registry container is running with 'docker ps | grep agentregistry'. If the container exited, check logs with 'docker logs agentregistry'. Port 12121 must not be in use by another service; check with 'lsof -i :12121'.

Generated config does not include newly registered servers

Re-run 'arctl generate-config --client claude-desktop' after registering new servers. The command reads the current registry state each time; any previously saved config file will be stale after registry changes.

Frequently Asked Questions about Agent Registry

What is Agent Registry?

Agent Registry is a Model Context Protocol (MCP) server that fast-track ai innovation with a centralized, trusted, curated registry It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Agent Registry?

Follow the installation instructions on the Agent Registry GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Agent Registry?

Agent Registry works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Agent Registry free to use?

Yes, Agent Registry is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "agentregistry": { "command": "npx", "args": ["-y", "agentregistry"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Agent Registry?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides