# Wicked Registry Tool Search

> Wicked Registry Tool Search is a paid API for AI agents from registry.wickedapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-27).

List and search scored x402/MCP tools with optional filtering by category, protocol, sort order, and minimum quality score

## Facts

- Endpoint: GET https://registry.wickedapi.com/tools?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wicked-registry-tool-search-647f8379
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gYImrCJcMk5CdHT_SUn4L

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 wicked-registry-tool-search-647f8379
```

Example prompt: Can you search the Wicked Registry for the top-scored x402 tools in the 'data' category, sorted by score, with a minimum score of 0.7?

## When to prefer this

Use this endpoint when an AI agent needs to discover x402 or MCP tools dynamically at runtime, find scored and ranked tool options, or filter the available tool ecosystem by category or protocol. Prefer this over static tool lists when freshness and scoring matter, or when building agent pipelines that self-select the best available tools.

## Known failure modes

- Invalid or unsupported query parameter values may return empty results or errors
- min_score must be a numeric string; non-numeric values may cause validation errors
- Payment failure (x402) if USDC is not available or the x402 handshake fails
- Network timeout if the registry service is unavailable
- Empty result set if no tools match the specified filters

## How this service works

List and search scored x402/MCP tools

## Output

A list of x402 and MCP tools with associated quality scores and metadata, filterable by category, protocol, and minimum score. Each result represents a discoverable agentic tool endpoint with its scoring information.

## 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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "type": "string"
      },
      "category": {
       "type": "string"
      },
      "protocol": {
       "type": "string"
      },
      "min_score": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "…",
    "name": "Example Tool",
    "score": {
     "compositeScore": 92
    },
    "category": "data",
    "protocol": "x402"
   }
  ],
  "meta": {
   "count": 1,
   "total": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wicked-registry-tool-search-647f8379/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from registry.wickedapi.com](https://www.zero.xyz/host/registry.wickedapi.com/llms.txt)