# Mermail Agent API Discovery Endpoint

> Mermail Agent API Discovery Endpoint is a free API for AI agents from console.mermail.app, callable via x402, Free, status unknown (last checked 2026-10-12).

Returns service metadata and configuration for the Mermail agent inbox and wallet API, including endpoint URLs, documentation links, and x402 payment details.

## Facts

- Endpoint: GET https://console.mermail.app/api?utm_source=zero.xyz
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mermail-agent-api-discovery-endpoint-9c00da21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y4ppX9hvWMqo5RfDDh_cx

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 mermail-agent-api-discovery-endpoint-9c00da21
```

Example prompt: Can you pull up the Mermail service discovery info so I can find the agent API base URL, OpenAPI spec, and the USDC payment receiver address I need to start connecting my AI agent?

## When to prefer this

Use this endpoint when you need to programmatically discover Mermail's API surface, locate the correct agent API base URL, retrieve the OpenAPI specification for code generation, or obtain the x402 USDC payment receiver address before making authenticated agent API calls. This is the canonical service-discovery entry point for Mermail integrations.

## Known failure modes

- Service unavailable — 503 if Mermail backend is down
- Unauthorized — 402 payment required if x402 payment header is missing or invalid
- Malformed request — 400 if unsupported HTTP method is used (only GET, HEAD, DELETE allowed)
- Empty or incomplete response if service is partially degraded

## How this service works

An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.

## Output

A JSON object containing the service name ('Mermail agent API'), the main API base URL, the agent-specific API base URL, an OpenAPI spec URL, a documentation URL, and x402 payment details including the USDC receiver wallet address and protocol name.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "service",
      "api_base_url",
      "agent_api_base_url",
      "documentation_url",
      "openapi_url",
      "payment"
     ],
     "properties": {
      "payment": {
       "type": "object",
       "required": [
        "protocol",
        "currency",
        "receiver"
       ],
       "properties": {
        "currency": {
         "type": "string",
         "const": "USDC"
        },
        "protocol": {
         "type": "string",
         "const": "x402"
        },
        "receiver": {
         "type": "string"
        }
       },
       "additionalProperties": false
      },
      "service": {
       "type": "string"
      },
      "openapi_url": {
       "type": "string",
       "format": "uri"
      },
      "api_base_url": {
       "type": "string",
       "format": "uri"
      },
      "documentation_url": {
       "type": "string",
       "format": "uri"
      },
      "agent_api_base_url": {
       "type": "string",
       "format": "uri"
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payment": {
   "currency": "USDC",
   "protocol": "x402",
   "receiver": "0xe943ca6F83E4585FB64c2118d36ac325e1bF149e"
  },
  "service": "Mermail agent API",
  "openapi_url": "https://console.mermail.app/openapi.json",
  "api_base_url": "https://console.mermail.app/api/v1",
  "documentation_url": "https://docs.mermail.app",
  "agent_api_base_url": "https://console.mermail.app/api/agent/v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mermail-agent-api-discovery-endpoint-9c00da21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from console.mermail.app](https://www.zero.xyz/host/console.mermail.app/llms.txt)