← Docs

Trust Levels

Every service in the AgentDNS registry has a trust level that determines how it appears in search results, whether it's health-monitored, and how much agents should trust it.

VerifiedCommunityUnverified
In search resultsDefaultDefaultHidden
Health monitoredHourlyN/AN/A
Manifest sourceService itselfAgentDNS teamThird party
API callableYesYesUse caution
Domain confirmedYesNoNo
Verified

The service hosts its own /.well-known/agent endpoint.

  • The registry has crawled and validated the live manifest
  • Health is actively monitored (checked hourly)
  • The domain is confirmed — this is the real service

This is the gold standard.

If you're a service provider, self-host your manifest to earn this badge. Use our SDKs to add the endpoint in 2 minutes.

Community

Manifest written and maintained by the AgentDNS team based on public API documentation.

  • The service itself has not adopted the protocol (yet)
  • The API works — agents can discover and call it through the gateway
  • Health monitoring is not available since there's no /.well-known/agent endpoint to check

If this API changes, the manifest may become outdated.

If you're the owner of a community-listed service and want to take ownership, contact us or self-host your manifest to upgrade to Verified.

Unverified

Submitted by a third party, not yet reviewed.

  • Hidden from search results by default
  • Use with caution — the manifest has not been validated by the AgentDNS team
  • May be promoted to Community after review, or removed if found to be malicious

How verification works

1

Your service hosts GET /.well-known/agent → returns a valid manifest JSON

2

Submit your domain at agent-dns.dev/submit or the registry discovers it

3

The registry fetches the manifest, validates it, and checks at least one detail_url resolves

4

If everything passes → Verified

5

The registry re-checks every hour. If 3 consecutive checks fail, the service is marked as unreachable

Want to upgrade from Community to Verified?

If your service is listed as Community and you want to take ownership:

1

Add the /.well-known/agent endpoint to your API (use our SDKs to do it in 2 minutes)

2

Submit your domain at /submit or contact us

3

The registry crawls your live endpoint and upgrades you to Verified

4

You now control your own manifest and get health monitoring

Add the protocol to your API

Use our SDKs for Express, FastAPI, Next.js, or Spring Boot. Add the /.well-known/agent endpoint in 2 minutes, get verified, and make your API discoverable by every AI agent.

Get started →