# Agent API Listings Package Builder

> Agent API Listings Package Builder is a paid API for AI agents from agent-api-listings.46-224-157-88.sslip.io, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-13).

Generates validated MPP and x402 directory listing packages from OpenAPI metadata for AI agent API discovery registries.

## Facts

- Endpoint: POST https://agent-api-listings.46-224-157-88.sslip.io/v1/packages
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-api-listings-package-builder-2dd64587
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X2sCCAdweYAvnNVAZLSqN

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-api-listings-package-builder-2dd64587 -d '<json body>'
```

Example prompt: Build me validated directory listing packages for my AI API — the origin is https://myservice.example.com, here's the OpenAPI spec, I want to target both mpp.dev and x402-list, and my contact email is dev@myservice.example.com.

## When to prefer this

Choose this endpoint when you need to generate validated, ready-to-submit listing packages for AI agent API directories (mpp.dev or x402-list) directly from an OpenAPI specification. It is the canonical tool for publishing x402-compatible services to agent marketplaces and automating the listing workflow, especially when you want both MPP and x402-list packages produced in a single call.

## Known failure modes

- Invalid or missing origin URL returns a validation error
- Malformed or incomplete OpenAPI object causes schema validation failure
- Missing required email when targeting x402-list without a contact email in OpenAPI spec returns an error
- Invalid target values outside ['mpp.dev','x402-list'] are rejected
- Exceeding maxItems limits on tags (20) or endpoint_paths (50) returns a validation error
- Payment not sent or insufficient USDC triggers 402 response before processing

## How this service works

Provide an API origin, inline OpenAPI document, and optional target list. Receive JSON with ready, blocked, or unsupported mpp.dev and x402-list packages and a static document-readiness report, without submission or directory fees.

## Output

Returns a JSON package set with format 'agent-api-listings-package-set-v1', listing each targeted directory (mpp.dev, x402-list) and the build status ('ready' or error details) for each. On success, validated listing packages are ready for submission to the respective directories.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Name",
   "default": null
  },
  "tags": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Tags",
   "maxItems": 20
  },
  "email": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 320
    },
    {
     "type": "null"
    }
   ],
   "title": "Email",
   "default": null,
   "description": "Required for a ready x402-list package unless openapi.info.contact.email contains a valid email"
  },
  "notes": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2000
    },
    {
     "type": "null"
    }
   ],
   "title": "Notes",
   "default": null
  },
  "origin": {
   "type": "string",
   "title": "Origin",
   "maxLength": 2048,
   "minLength": 1
  },
  "openapi": {
   "type": "object",
   "title": "Openapi",
   "additionalProperties": true
  },
  "targets": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "enum": [
       "mpp.dev",
       "x402-list"
      ],
      "type": "string"
     },
     "maxItems": 2,
     "minItems": 1
    },
    {
     "type": "null"
    }
   ],
   "title": "Targets",
   "default": null
  },
  "category": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 100
    },
    {
     "type": "null"
    }
   ],
   "title": "Category",
   "default": null
  },
  "service_id": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 100
    },
    {
     "type": "null"
    }
   ],
   "title": "Service Id",
   "default": null
  },
  "website_url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048
    },
    {
     "type": "null"
    }
   ],
   "title": "Website Url",
   "default": null
  },
  "provider_name": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Provider Name",
   "default": null
  },
  "endpoint_paths": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Endpoint Paths",
   "maxItems": 50
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "format": "agent-api-listings-package-set-v1",
  "results": {
   "mpp.dev": {
    "status": "ready"
   },
   "x402-list": {
    "status": "ready"
   }
  },
  "targets": [
   "mpp.dev",
   "x402-list"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-api-listings-package-builder-2dd64587/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-api-listings.46-224-157-88.sslip.io](https://www.zero.xyz/host/agent-api-listings.46-224-157-88.sslip.io/llms.txt)