# Agent Tools API Endpoint Finder (x402)

> Agent Tools API Endpoint Finder (x402) is a paid API for AI agents from agent-tools.faling-bot.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Finds the matching API endpoint URL and spec for a given API and natural-language query, paid per-call via x402 USDC microtransaction.

## Facts

- Endpoint: POST https://agent-tools.faling-bot.workers.dev/api/api-endpoint?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-tools-api-endpoint-finder-x402-6ab4911f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__vS_r_ZHx2srea76WfWee

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 agent-tools-api-endpoint-finder-x402-6ab4911f -d '<json body>'
```

Example prompt: Using Agent Tools, find the endpoint I need to call on the GitHub API to list open issues for a repository — give me the matched endpoint paths and the spec URL.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover the correct API path to call for a given task, without hardcoding endpoint URLs. Ideal for agents orchestrating calls across multiple APIs or working with unfamiliar APIs at runtime. Requires no signup or API key — only a USDC micropayment on Base or Solana via x402.

## Known failure modes

- No matching endpoints found if the query is too vague or the API name is not recognized
- Payment failure if the x402 USDC microtransaction is not completed correctly
- Invalid or unreachable spec_url causes lookup failure
- Ambiguous query returns too many or irrelevant endpoint matches

## How this service works

Pay-per-call web tools for AI agents. No signup, no API key: pay USDC on Base or Solana per request via x402.

## Output

Returns an array of matched API endpoint objects (paths, methods, descriptions) along with the base URL of the target API and the URL of the OpenAPI spec that was searched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "api": {
   "type": "string"
  },
  "query": {
   "type": "string",
   "description": "what you want to do, e.g. 'list repository issues'"
  },
  "spec_url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "matches": {
   "type": "array"
  },
  "base_url": {
   "type": "string"
  },
  "spec_url": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-tools-api-endpoint-finder-x402-6ab4911f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-tools.faling-bot.workers.dev](https://www.zero.xyz/host/agent-tools.faling-bot.workers.dev/llms.txt)