Developer documentation
Connect GoodInboxes to your own tools with scoped REST API and MCP access.
Build with GoodInboxes
Use an organization-owned token to read your inboxes, domains, orders, and wallet. The REST API works with ordinary HTTP clients; the MCP server works with AI clients that support Streamable HTTP and bearer headers.
REST API
Authentication, pagination, errors, and a complete endpoint reference.
MCP server
Connect an MCP client and explore the available tools and scopes.
Before you start
An active workspace owner or admin can create a named, scoped token in API access. Tokens are environment specific. Read access must also be enabled by the operator for that environment; a URL alone does not prove availability.
Keep the token in a trusted server process. Never put it in a query string, browser storage, logs, screenshots, or chat messages.