# AgentTools Directory Search

> AgentTools Directory Search is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Search a catalog of x402-paid APIs by natural language capability description, returning matched tools from the AgentTools catalog and optionally the live x402 Bazaar marketplace.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/dev/directory-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-directory-search-527c7002
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VZh9_qnZgA0shhK_1SqaO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agenttools-directory-search-527c7002
```

Example prompt: Search the AgentTools catalog for any APIs that can geocode an IP address — include Bazaar results too and give me up to 5 matches.

## When to prefer this

Use this endpoint when an AI agent does not know which specific API to call and needs to discover available paid tools by describing the capability it requires. It is the meta-tool for dynamic tool discovery within the x402 ecosystem, especially useful for agentic pipelines that self-assemble their toolchain at runtime rather than relying on hardcoded API integrations.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Empty results when no tools match the capability description
- Bazaar unavailable or slow when includeBazaar=true, potentially causing timeout
- Malformed query string may return irrelevant or zero results
- x402 payment failure prevents the request from being processed

## How this service works

Describe what you need and get back matching x402-paid APIs: our own catalog (54 tools) plus, optionally, the live x402 Bazaar of third-party sellers. The agent's meta-tool — instead of knowing an API exists, ask for the capability. Use this when an agent needs to "I need a tool that does X" → matched paid APIs.

## Output

A list of matched API tools from the AgentTools catalog (54 tools) and optionally the live x402 Bazaar, each entry including the tool name, description, pricing, and endpoint details relevant to the requested capability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "number",
       "description": "Max results per source"
      },
      "query": {
       "type": "string",
       "description": "What do you need?"
      },
      "includeBazaar": {
       "enum": [
        "true",
        "false"
       ],
       "type": "string",
       "description": "Include third-party Bazaar results"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttools-directory-search-527c7002/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)