# ForgeMesh x402 Agent Service Directory

> ForgeMesh x402 Agent Service Directory is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a categorized directory of ForgeMesh's 11 x402 paid services with endpoint counts and price ranges, optionally filtered by category, to help agents choose which paid tool to call next.

## Facts

- Endpoint: POST https://x402.forgemesh.io/agent-service-directory
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-x402-agent-service-directory-8379f813
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XYb6yRcWrtjmiZLXOgKtx

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 forgemesh-x402-agent-service-directory-8379f813 -d '<json body>'
```

Example prompt: Show me all ForgeMesh x402 services in the onchain-intel category — I need to see what's available, how many endpoints each has, and the price range so I can pick which one to call next.

## When to prefer this

Use this endpoint when an agent needs to discover which ForgeMesh paid service is appropriate for a task before committing to a call — especially when the right product id is needed to fetch full route schemas from fleet-product-detail. Prefer over sibling catalog endpoints when category-level filtering is needed to narrow choices efficiently.

## Known failure modes

- Invalid category value returns empty results or error — must be one of: onchain-intel, voice, travel, econ-intel, commerce, infra, media, utility-grid
- Payment not processed (x402 protocol failure) results in no data returned
- Upstream live API discovery outage may cause stale or incomplete service listings
- POST with malformed JSON body returns 400-level error

## How this service works

A directory built for agents choosing which paid tool to call next: 11 ForgeMesh x402 services with category, endpoint counts, and price ranges, refreshed from each service's live API discovery output. Optional category filter narrows results. Returns the product id needed to fetch full call shapes from fleet-product-detail.

## Output

A list of up to 11 ForgeMesh x402 services filtered by the requested category (or all categories if none specified), each with its name, category, number of live routes, price range, and the product id needed to retrieve full call shapes from the fleet-product-detail endpoint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "category": {
   "type": "string",
   "description": "Optional: onchain-intel, voice, travel, econ-intel, commerce, infra, media, utility-grid"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "category": "onchain-intel",
  "products": [
   {
    "id": "onchain-anomaly",
    "host": "anomaly.forgemesh.io",
    "name": "Blockchain & Market Anomaly Detection",
    "summary": "Paid real-time anomaly detection via x402. Mempool, whale alerts, stablecoin depegs, and GitHub trending signals.",
    "category": "onchain-intel",
    "price_range": {
     "max": 0.05,
     "min": 0.01
    },
    "route_count": 16
   }
  ],
  "categories": [
   "commerce",
   "econ-intel",
   "infra",
   "media",
   "onchain-intel",
   "travel",
   "utility-grid",
   "voice"
  ],
  "generated_at": "2026-07-17T11:53:32.075Z",
  "total_products": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-x402-agent-service-directory-8379f813/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)