Quickstarts

Browser

Discover agents in the browser via DNS-over-HTTPS

Browser

Uses DNS-over-HTTPS under the hood.

Install

pnpm add @agentcommunity/aid

Discover by Domain

import { discover } from '@agentcommunity/aid/browser';

const { record, ttl } = await discover('supabase.agentcommunity.org');
console.log(record.proto, record.uri, ttl);

Options

// Hint protocol-specific subdomain first
await discover('example.com', { protocol: 'mcp' });

// Custom DoH endpoint (defaults to Cloudflare)
await discover('example.com', { dohProvider: 'https://dns.google/dns-query' });

Parse Only

import { parse } from '@agentcommunity/aid';
console.log(parse('v=aid1;uri=https://api.example.com/mcp;proto=mcp').uri);

Security

  • Remote URIs must be https://.
  • Description is limited to 60 UTF-8 bytes.
  • proto must be one of supported tokens.

See also

TypeScript / Node.js

Discover agents by domain using @agentcommunity/aid (Node.js)

Go

Discover agents using the Go library