Skip to content

pmuir/agentregistry

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

72 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Agent Registry

Go Version License Discord

A centralized registry to securely curate, discover, deploy, and manage agentic infrastructure from MCP servers, agents to skills.

What is Agent Registry?

Agent Registry brings governance and control to AI artifacts and infrastructure, empowering developers to quickly build and deploy AI applications with confidence. It provides a secure, centralized registry where teams can publish, discover, and share AI artifacts, including MCP servers, agents, and skills, and deploy them seamlessly to any environment.

Agent Registry provides:

  • πŸ“¦ Centralized Registry: Package, discover and curate AI artifacts from a central source
  • πŸ”’ Control and Governance: Selectively and control custom collection of artifacts
  • πŸ“Š Data Enrichment: Automatically validate and score ingested data for insights
  • 🌐 Unify AI Infrastructure: Deploy and access artifacts anywhere

Agent Registry Architecture

For Operators: Enrich, package, curate and deploy with control

Architecture

For Developers: Build, push, pull and run applications with confidence

Architecture

Development setup

See DEVELOPMENT.md for detailed architecture information.

πŸš€ Quick Start

Prerequisites

  • Docker Desktop with Docker Compose v2+
  • Go 1.25+ (for building from source)

Installation

# Install via script (recommended)
curl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/get-arctl | bash

# Or download binary directly from releases
# https://github.com/agentregistry-dev/agentregistry/releases

Start the Registry

# Start the registry server and look for available MCP servers
arctl mcp list

# The first time the CLI runs it will automatically start the registry server daemon and import the built-in seed data.

Access the Web UI

# Launch the embedded web interface
arctl ui

# Open http://localhost:8080 in your browser

πŸ“š Core Concepts

MCP Servers

MCP (Model Context Protocol) servers are services that provide tools, resources, and prompts to AI agents. They're the building blocks of agent capabilities.

Agent Gateway

The Agent Gateway is a reverse proxy that provides a single MCP endpoint for all deployed servers:

sequenceDiagram
    participant IDE as AI IDE/Client
    participant GW as Agent Gateway
    participant FS as filesystem MCP
    participant GH as github MCP
    
    IDE->>GW: Connect (MCP over HTTP)
    GW-->>IDE: Available tools from all servers
    
    IDE->>GW: Call read_file()
    GW->>FS: Forward to filesystem
    FS-->>GW: File contents
    GW-->>IDE: Return result
    
    IDE->>GW: Call create_issue()
    GW->>GH: Forward to github
    GH-->>GW: Issue created
    GW-->>IDE: Return result
Loading

IDE Configuration

Configure your AI-powered IDEs to use the Agent Gateway:

# Generate Claude Desktop config
arctl configure claude-desktop

# Generate Cursor config
arctl configure cursor

# Generate VS Code config
arctl configure vscode

🀝 Get Involved

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Show your support

Related Projects

πŸ“š Resources

πŸ“„ License

MIT License - see LICENSE for details.


About

agentregistry and runtime

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Go 75.6%
  • TypeScript 18.9%
  • PLpgSQL 3.1%
  • Shell 0.7%
  • Makefile 0.6%
  • Python 0.5%
  • Other 0.6%