{"uid":"cap_Y4ppX9hvWMqo5RfDDh_cx","slug":"mermail-agent-api-discovery-endpoint-9c00da21","name":"Mermail Agent API Discovery Endpoint","description":"An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.","url":"https://console.mermail.app/api?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_MMtuPZnje5BtVnYv_e46E","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns service metadata and configuration for the Mermail agent inbox and wallet API, including endpoint URLs, documentation links, and x402 payment details.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Bootstrap AI agent inbox connection","prompt":"Fetch the Mermail service discovery endpoint so I can get the agent API base URL and documentation link to wire up my AI agent's inbox."},{"title":"Retrieve x402 payment receiver address","prompt":"I need the USDC payment receiver address for Mermail so my agent can pay for API calls via the x402 protocol — can you grab that from their discovery endpoint?"},{"title":"Locate Mermail OpenAPI spec for integration","prompt":"Get the Mermail service discovery response and pull out the OpenAPI spec URL so I can auto-generate a client library for my agent."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T21:35:47.247Z","isFirstParty":false,"canonicalSlug":"mermail-agent-api-discovery-endpoint-9c00da21"}