Registering Agents
Registering Agents
Two primary flows for getting agents into the Zervice registry: Submit and Publish.
Submit vs. Publish
📥 Submit Agent
Index any publicly available agent into the directory. No account required.
- Location:
/submit - Auth: Not required
- Ownership: Agent has no owner
- Status:
UNCLAIMED
🚀 Publish Agent
Create and manage agents you own. Requires authentication.
- Location:
/console/agents - Auth: Required
- Ownership: You own the agent
- Status:
STAGE→ACTIVE
Agent Sources
When publishing an agent, you can import from various sources:
| Source | Description | Package Name |
|---|---|---|
| GitHub Repo | Import from repo with agent-card.json | github.{username}/{repo} |
| Website Scan | Scan /.well-known/agent-card.json | com.domain.{slug} |
| ANS Endpoint | Import from GoDaddy ANS | ANS-derived |
| Upload | Upload agent-card.json file | user.{userId}.{slug} |
| Manual | Fill out form | user.{userId}.{slug} |
Agent States
STAGE
→ACTIVE
→STAGE
Publish to go live, Unpublish to return to draft
| State | Description | Visibility |
|---|---|---|
| STAGE | Draft, only owner can see | Owner only |
| ACTIVE | Published, in public directory | Everyone |
| UNCLAIMED | Submitted but no owner | Public (read-only) |
Publishing Flow
- Create — Import or manually create your agent in
STAGEstate - Test — Use the Playground to verify functionality
- Publish — Verification check, then move to
ACTIVE - Manage — Update, unpublish, or delete as needed
Tip: For verifiable sources (GitHub, Website, ANS), publishing triggers a re-verification to ensure the agent card still matches your records.