Tools

$ npx agent-root

CLI and MCP server for searching, installing, and managing AgentRoot records from your terminal or AI client.

// cli

CLI

The AgentRoot CLI lets you search the registry, install records into your project, validate your own zone, and manage your configuration.

Installation

No install needed. Run directly with npx:

$ npx agent-root

Or install globally via npm:

$ npm install -g agent-root

Or use the one-line installer (installs Node if needed):

$ curl -sf https://agentroot.io/install-cli.sh | sh

search

Search the AgentRoot registry for agents, MCP servers, skills, and A2A endpoints.

# Search all record types
$ npx agent-root search "database tools"

db-tools mcp example.com
  Database query and visualization tools
  transport: sse | tools: query_database, visualize_data

sql-helper skill devtools.io
  SQL query writing and optimization skills
  skills: write-sql, optimize-query

# Filter by type
$ npx agent-root search "database" --type mcp
$ npx agent-root search "deploy" --type skill

install

Install a record into your local project. For MCP servers, adds configuration to your AI client. For skills, downloads SKILL.md files.

# Install an MCP server
$ npx agent-root install example.com/db-tools
Installed db-tools (MCP, sse) from example.com
  Added to .claude/mcp.json

# Install a skill
$ npx agent-root install devtools.io/coding-helpers
Installed 3 skills from devtools.io/coding-helpers
  lint-fix    → .agents/skills/lint-fix/SKILL.md
  test-gen    → .agents/skills/test-gen/SKILL.md
  deploy      → .agents/skills/deploy/SKILL.md

# Install for a specific client
$ npx agent-root install example.com/db-tools --client cursor
$ npx agent-root install example.com/db-tools --client claude

zone

Inspect a domain's zone file.

# View a zone
$ npx agent-root zone example.com

example.com verified
  zone: https://example.com/.well-known/agentroot.json
  records: 3

  assistant    agent   A research assistant
  db-tools     mcp     Database query and visualization tools
  coding-helpers skill  Skills for linting, testing, and deployment

validate

Validate your own domain's AgentRoot setup. Checks DNS record, fetches the zone file, and reports any issues.

$ npx agent-root validate yourdomain.com

DNS record       found  _agentroot.yourdomain.com TXT "v=ar1 zone=https://..."
Zone file        valid  3 records parsed
Domain match     ok     yourdomain.com
HTTPS            ok     TLS valid
Records
  assistant      agent   ok
  db-tools       mcp     ok
  helpers        skill   ok

All checks passed.

// mcp_server

MCP Server

The AgentRoot MCP server gives AI clients direct access to the registry. Your AI can search for tools, inspect zones, and install records without leaving the conversation.

Installation

$ npx @agent-root/mcp-server

Available tools

search_records

Search the AgentRoot registry by query and type. Returns matching records with descriptions, endpoints, and metadata.

get_zone

Get the full zone for a domain. Returns all records, subdomain references, and verification status.

install_record

Install a record into the current project. For MCP servers, adds client configuration. For skills, downloads SKILL.md files.

list_installed

List all AgentRoot records installed in the current project.

Claude Code configuration

Add to your .claude/mcp.json:

{
  "mcpServers": {
    "agentroot": {
      "command": "npx",
      "args": ["@agent-root/mcp-server"]
    }
  }
}

Then in Claude Code, you can say: "Search AgentRoot for database MCP servers" or "Install the db-tools MCP from example.com".

Cursor configuration

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "agentroot": {
      "command": "npx",
      "args": ["@agent-root/mcp-server"]
    }
  }
}

Usage examples

// In your AI client conversation:

"Search AgentRoot for MCP servers that handle database queries"
// → Calls search_records with q="database queries" type="mcp"

"Show me what's on example.com's AgentRoot zone"
// → Calls get_zone with domain="example.com"

"Install the db-tools MCP server from example.com"
// → Calls install_record with domain="example.com" record_id="db-tools"

"What AgentRoot tools do I have installed?"
// → Calls list_installed

// next

← API Reference

Guide

Publish an Agent →