list_inboxes
Retrieve all active disposable email inboxes associated with your API key. Use this tool to manage and monitor multiple inboxes for receiving verification emails and OTP codes.
Instructions
List all active inboxes for the current API key.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- mcp-server/src/index.ts:88-96 (handler)The server.tool('list_inboxes', ...) call that defines the tool handler. It calls blipFetch('/v1/inboxes') and returns the result as JSON text.
server.tool( "list_inboxes", "List all active inboxes for the current API key.", {}, async () => { const result = await blipFetch("/v1/inboxes"); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } ); - mcp-server/src/index.ts:88-96 (registration)The tool is registered via server.tool() on the MCP server instance. No separate registration file exists; registration and handler are co-located.
server.tool( "list_inboxes", "List all active inboxes for the current API key.", {}, async () => { const result = await blipFetch("/v1/inboxes"); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } ); - mcp-server/src/index.ts:91-91 (schema)The schema (validation) for list_inboxes is an empty object '{}', meaning it takes no input parameters.
{}, - mcp-server/src/index.ts:24-45 (helper)The blipFetch helper function used by list_inboxes to make authenticated API calls to the Blip API.
async function blipFetch( path: string, options: RequestInit = {} ): Promise<unknown> { const url = `${API_URL}${path}`; const res = await fetch(url, { ...options, headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json", ...options.headers, }, }); if (!res.ok) { const body = await res.text(); throw new Error(`Blip API error ${res.status} on ${options.method || "GET"} ${path}: ${body}`); } if (res.status === 204) return null; return res.json(); }