SDKs

npm install @agentdns/client

import { resolve } from '@agentdns/client';

const { matches } = await resolve({ capability: 'contract-review' });
const best = matches[0];
// best.a2a_endpoint, best.mcp_server_url, best.api_endpoint, best.trust_score

import { AgentDNSClient } from '@agentdns/client';

const client = new AgentDNSClient({ apiKey: process.env.AGENTDNS_API_KEY });

const { matches } = await client.resolve({
  capability: ['contract-review', 'redlining'],
  protocol: 'a2a',
  limit: 5,
});

const { agent } = await client.getAgent('legal-ai');
const { agents } = await client.searchAgents({ q: 'contract', verified: true });

import { AgentDNSError } from '@agentdns/client';

try {
  await client.resolve({ capability: 'x' });
} catch (e) {
  if (e instanceof AgentDNSError) {
    console.error(e.code, e.status, e.message);
  }
}

pip install agentdns

from agentdns import resolve

result = resolve(capability="contract-review")
best = result.matches[0]
# best.a2a_endpoint, best.mcp_server_url, best.api_endpoint, best.trust_score

from agentdns import AgentDNSClient

client = AgentDNSClient(api_key="adns_k1_...")  # or set AGENTDNS_API_KEY env var

result = client.resolve(
    capability=["contract-review", "redlining"],
    protocol="a2a",
    limit=5,
)

agent = client.get_agent("legal-ai")
listing = client.search_agents(q="contract", verified=True)

import asyncio
from agentdns import AsyncAgentDNSClient

async def main():
    async with AsyncAgentDNSClient() as client:
        result = await client.resolve(capability="contract-review")
        print(result.matches[0].trust_score)

asyncio.run(main())

from agentdns import AgentDNSError, resolve

try:
    resolve(capability="x")
except AgentDNSError as e:
    print(e.code, e.status, str(e))

pip install agentdns-langchain

from agentdns_langchain import AgentDNSTool
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_openai import ChatOpenAI

resolver = AgentDNSTool(capability="contract-review", protocol="a2a", limit=3)

llm = ChatOpenAI(model="gpt-4o")
agent = create_tool_calling_agent(llm, [resolver], prompt=...)
AgentExecutor(agent=agent, tools=[resolver]).invoke({"input": "Find me a contract review agent"})

pip install agentdns-crewai

from agentdns_crewai import AgentDNSResolveTool
from crewai import Agent, Task, Crew

resolver = AgentDNSResolveTool(capability="contract-review", protocol="a2a")

legal = Agent(
    role="Legal researcher",
    goal="Find and orchestrate the best contract-review agent",
    tools=[resolver],
)

Crew(agents=[legal], tasks=[Task(description="Route this NDA", agent=legal)]).kickoff()

pip install agentdns-agno

from agno.agent import Agent
from agno.models.anthropic import Claude
from agentdns_agno import AgentDNSTools

agent = Agent(
    model=Claude(id="claude-sonnet-4-6"),
    tools=[AgentDNSTools()],
    instructions="When the user asks for a capability, first resolve via AgentDNS, then orchestrate.",
)

agent.print_response("Find an MCP server that can scrape web pages")