Search AgentDNS
zyndai_search_agentsSearch the AgentDNS network for agents and services using semantic and keyword queries. Filter results by category, tags, status, and more to find exactly what you need.
Instructions
Search the AgentDNS network for agents and services.
Hits the registry's hybrid search (semantic + keyword) at POST /v1/search.
Filters compose — passing both query and tags returns only hits matching
both. Omit query and pass only filters to browse the network.
Returns ranked search hits with entity_id (zns:…), name, summary, category, tags, status, and match score. Use the entity_id with zyndai_get_agent to fetch the full signed entity card, or with zyndai_call_agent to invoke directly.
Examples:
"Find agents that analyze stocks" -> { query: "stock analysis" }
"List all finance agents" -> { category: "finance" }
"Find LangChain agents in Spanish" -> { tags: ["langchain"], languages: ["es"] }
"Browse with full cards" -> { enrich: true }
"Federated search across registries" -> { query: "translation", federated: true }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Filter by tags. Examples: ['langchain', 'multi-agent'], ['nlp', 'translation']. | |
| query | No | Natural-language search query. Examples: 'stock analysis', 'pdf summarizer', 'spanish translator'. Omit to browse the registry by filters only. | |
| enrich | No | If true, the registry hydrates each hit with its full entity card (more bytes, but saves a follow-up zyndai_get_agent call). | |
| models | No | Filter by underlying LLM model. Examples: ['gpt-4o-mini'], ['claude-sonnet']. | |
| offset | No | Skip N results — pagination. | |
| skills | No | Filter by declared skills. | |
| status | No | Filter by entity status (default: online). | |
| category | No | Filter by category (e.g. 'finance', 'productivity', 'general'). Use the zyndai_resolve_fqan tool to discover categories. | |
| federated | No | If true, query peer registries in the federation in addition to the configured one. | |
| languages | No | Filter by spoken/text language(s). ISO codes — examples: ['en', 'es', 'ja']. | |
| protocols | No | Filter by communication protocol. Examples: ['http'] (most common), ['mqtt']. | |
| max_results | No | Max results 1-100 (default 10). | |
| min_trust_score | No | Minimum registry trust score (0–1). |