Your domain is your identity. Add a DNS record, host your SKILL.md files, and every AI tool on the internet can find and install your skills. No accounts. No approval. Just DNS.
AgentRoot supports four record types. Publish one, or put them all in a single zone file.
Agent
type: agent
An autonomous AI agent that accepts tasks and returns results. REST, A2A, or any protocol.
MCP Server
type: mcp
A Model Context Protocol server that exposes tools to AI applications. SSE, stdio, or streamable-http.
Skills
type: skill
SKILL.md files — instructions that teach AI coding agents how to perform tasks. The open standard.
A2A Endpoint
type: a2a
Agent-to-Agent protocol endpoint for multi-agent systems. Streaming, push, and task management.
I just have a URL
No DNS setup needed
Paste a link to a SKILL.md file. Listed as unverified.
// step 2
Build your record
Fill in the fields below. For a single record, use inline DNS. For multiple records, create a zone file at .well-known/agentroot.json.
This URL points to your index.json file, which lists your skills. Each skill links to a SKILL.md file. See step 3 below for the format.
Direct link to a single SKILL.md file. GitHub blob URLs are auto-converted to raw URLs. The file must have a name (and optionally description) in YAML frontmatter or a markdown table.
DNS propagation usually takes minutes, sometimes up to 24 hours.
Field reference
Field
Required
Description
v
required
Always agent1
name
required
Short display name, no spaces
caps
required
Comma-separated capabilities, lowercase
endpoint
optional
URL where this agent can be called
proto
optional
Protocol: rest, a2a, mcp, openapi, etc.
desc
optional
Description (escape spaces with \ )
card
optional
URL to agent-card.json
Field
Required
Description
v
required
Always skill1
index
one of
URL to your skills index.json (for multiple skills)
skill_md
one of
URL to a single SKILL.md file (GitHub blob URLs auto-converted)
Provide either index or skill_md, not both.
// step 3 — for skills
The SKILL.md open standard
If you're publishing skills, each skill is a directory with a SKILL.md file. This is the open standard used across the agent ecosystem — write once, works everywhere.
Claude CodeOpenAI CodexGemini CLIGitHub CopilotCursorWindsurf
{
"schema": "agent-skills/1.0",
"domain": "yourdomain.com",
"skills": [
{
"id": "my-skill",
"name": "My Skill",
"description": "What this skill does in one sentence",
"skill_md": "https://yourdomain.com/.agents/skills/my-skill/SKILL.md"
}
]
}
SKILL.md format
---
name: my-skilldescription: What this skill does and when to trigger it
---
# My Skill
Instructions for how the agent should use this skill.
## When to use
Use this skill when the user wants to...
## API EndpointsGET https://yourdomain.com/api/search?q=<query>
## Example
...
Publishing agents only? Skip this step — agents don't need SKILL.md files. The DNS TXT record is enough.
// step 4
Submit your domain
Once your DNS record is set (and your index.json is hosted, if publishing skills), tell AgentRoot to look you up.
# Or submit via the API
curl -X POST https://agentroot.io/api/submit \
-H "Content-Type: application/json" \
-d '{"domain": "yourdomain.com"}'
Must be a publicly accessible SKILL.md file with name and description — either as YAML frontmatter or in a markdown table.
# Or submit via the API
curl -X POST https://agentroot.io/api/submit-url \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/SKILL.md"}'
Want the green checkmark? Add a DNS TXT record to prove you own this domain. Takes 2 minutes. See step 2.
// step 5
What happens next
Once submitted, your agent or skills are immediately discoverable.
✓
Instant indexing Your domain appears in the public registry immediately after submission.
✓
API-discoverable Other agents and developers can find you via GET /api/discover, /api/find-skills, or the registry UI.
✓
Re-verified automatically AgentRoot re-checks your DNS record periodically. Your DNS is always the source of truth — update or remove it anytime.
✓
Installable everywhere Anyone can install your skills in Claude Code, Codex CLI, Gemini CLI, and more — because they follow the open SKILL.md standard.
// subdomains
Multiple agents per domain
Use subdomains to register multiple agents or skills. Submit each separately.
_agent.example.com → main agent
_agent.radar.example.com → signal intelligence agent
_skill.api.example.com → public API skills