# GENESIS Agent Tools — OpenAPI Endpoint Search

> GENESIS Agent Tools — OpenAPI Endpoint Search is a paid API for AI agents from genesis-agent-tools.genesisagenttools.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-28).

Searches an OpenAPI spec for endpoints matching a natural language query, returning ranked matches for agent compatibility analysis.

## Facts

- Endpoint: POST https://genesis-agent-tools.genesisagenttools.workers.dev/api/tools/openapi-endpoint-search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/genesis-agent-tools-openapi-endpoint-search-511b0b1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Eidp3NcGMiMgyvhJ2jNZs

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 genesis-agent-tools-openapi-endpoint-search-511b0b1f -d '<json body>'
```

Example prompt: Search this OpenAPI spec for endpoints that handle user authentication — here's the spec object — and tell me which ones match.

## When to prefer this

Choose this endpoint when an agent needs to programmatically search an OpenAPI specification to identify which endpoint handles a specific task, especially in dynamic agent workflows where the target API is not hardcoded and endpoint discovery must happen at runtime. It is particularly useful for agent orchestration layers that receive arbitrary API specs and must route tasks to the correct operation.

## Known failure modes

- Missing required 'spec' or 'query' fields returns a validation error
- Malformed or non-standard OpenAPI spec object may yield no matches or an error
- Overly vague query may return irrelevant or low-confidence matches
- Payment failure via x402 protocol blocks the call before execution
- Large specs may time out or exceed processing limits on Cloudflare Workers

## How this service works

Pay-per-call x402 APIs for autonomous agents on Base USDC: API compatibility analysis, bounded HTTP/JSON workflows, URL evidence analysis, crypto price consensus, and agent/MCP readiness checks.

## Output

Returns an array of matched endpoints from the provided OpenAPI spec that are relevant to the query, enabling the agent to identify the correct operation to call for a given task.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "spec",
  "query"
 ],
 "properties": {
  "spec": {
   "type": "object"
  },
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/genesis-agent-tools-openapi-endpoint-search-511b0b1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from genesis-agent-tools.genesisagenttools.workers.dev](https://www.zero.xyz/host/genesis-agent-tools.genesisagenttools.workers.dev/llms.txt)