Connect any MCP client to Unitpost
Any streamable-HTTP MCP client that speaks MCP OAuth connects with just the URL. Anything else uses a Bearer API key.
Connect with OAuth (recommended)
Point the client at the server URL below. A spec-compliant client discovers OAuth itself: it reads the
WWW-Authenticate: Bearer resource_metadata="…"challenge on the first 401, fetches/.well-known/oauth-protected-resource, runs the PKCE code flow against the advertised authorization server, and retries with the token. No key to copy. Your client opens Unitpost in the browser — pick a workspace, approve the scopes, and you're connected. Tokens refresh automatically.Server URL https://mcp.unitpost.com/mcp Transport Streamable HTTP Auth (recommended) OAuth 2.1 — add the URL, approve in the browser Auth (legacy) Authorization: Bearer pk_live_YOUR_KEY Tools one per API operation (email_send, email_campaigns_send, …) Toolsets (optional) https://mcp.unitpost.com/mcp?toolsets=default,campaigns Discover tools
The server advertises one tool per API operation (
email_send,email_campaigns_send,email_domains_verify, …). A write'sbodymaps to the API request body. Every tool declaressecuritySchemes: [{ type: "oauth2", scopes: […] }]so linking-aware clients (ChatGPT) show the Connect UI.Choose toolsets (optional)
With no parameters the server lists its default set of tools, the same list it always has. Newer tools come in groups: add
?toolsets=to the URL, or send anX-MCP-Toolsetsheader, with any ofaudience,templates,campaigns,sending,inbox,domainsandworkspace(the server instructions list every group), plusdefaultfor the standard set andallfor everything.?readonly=1(X-MCP-Readonly: 1) lists only read tools and refuses writes;?scoped=1(X-MCP-Scoped: 1) hides tools your key can't call. Fewer tools means less of the model's context spent on tool definitions.Texthttps://mcp.unitpost.com/mcp?toolsets=default,campaigns,templatesVerify
Call a read tool (e.g. list domains). An unauthenticated call answers 401 with a
WWW-Authenticate: Bearer resource_metadata="…"challenge (start OAuth there). With a key, a 401 Invalid API key usually means a missingBearerprefix or a mistyped key — recreate the key and retry.Don't see it? Fully quit and reopen the client — closing the window is often not enough — then check again.
No browser on this machine? For headless setups, CI, SSH, or clients that can only paste a key, use the API-key setup instead.