Your domain is your identity. Add a DNS record, and every AI tool on the internet can discover your agents, MCP servers, skills, and A2A endpoints. 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. Expand the format guide below for details.
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.
SKILL.md format guide
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>
// generated output
// fill in the fields above
DNS Name:_agentroot.yourdomain.com
· Type:TXT
· Value:v=ar1 zone=https://yourdomain.com/.well-known/agentroot.json
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, skill_md, or skills — exactly one.
// step 3
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"}'