AI Assistant (MCP)

Oppizi plugs straight into your AI assistant through an MCP server (Model Context Protocol). Connect Claude, Cursor, ChatGPT, or any MCP-capable tool with a single browser sign-in — no API keys to copy — then create campaigns, pull performance, and check pricing just by asking.

Server URL

https://developer-api.oppizi.com/client/mcp

Transport: Streamable HTTP (stateless JSON-RPC). Authentication: OAuth 2.1 — you sign in with your Oppizi account and approve the access you want; there are no keys to paste, store, or rotate.

Connect

1. In your AI assistant, add a remote MCP server (sometimes called a connector or integration) using the URL above.
2. Your assistant opens a browser window on auth.oppizi.com — sign in with your Oppizi account (the same one you use for the platform).
3. Review and approve the requested access. Your assistant is now connected.

Client examples

Claude Code

claude mcp add --transport http oppizi https://developer-api.oppizi.com/client/mcp

Claude.ai — Settings → Connectors → Add custom connector → paste the server URL.

Cursor — Settings → MCP → Add server → choose Streamable HTTP → paste the server URL.

ChatGPT / other MCP clients — add a remote MCP server with the URL above and complete the browser sign-in.

What you can do

Create campaigns by conversation

Describe the campaign you want and your assistant builds it with you, step by step — the same flow as the Oppizi self-serve wizard, in chat:

• Direct Mail to your own list (ADM) — mail postcards to an address list you've uploaded.
• Every Door Direct Mail (EDDM) — saturate every household in the USPS routes you choose.
• Pick the mail piece format, attach one of your designs, choose targeting, and set the launch date.

The builder walks the steps create → set targeting → select design → link audience → set details → submit, and tells you what's still missing before it can be submitted.

Ask about performance

Pull your own results in seconds — no report building:

• Analytics over time, by city, by week, by creative, and A/B — scans, reach, conversions, CVR, and your own revenue & ROI.
• Scans — unique scans, scan conversion rate, distribution progress.
• Status & schedule — where each campaign sits in the pipeline and its live dates.
• Coupons & creative — your flyer codes and the artwork on each campaign.
• Conversions — read back the conversions you've tracked, alongside your campaign results.

Know the cost up front

• Instant quotes — flyer-distribution and EDDM cost calculators, on demand.
• Pre-submit estimate — the price of the campaign you're assembling, before it goes to review.

Track conversions

Record signups and purchases back to Oppizi and read them alongside your campaign results, powering richer attribution and your own reporting.

Access & scopes

You approve exactly the access you want at sign-in.

Access tokens are short-lived (15 minutes) and refreshed automatically.

Safety

• Sign in, don't paste. Connections use standard OAuth; the token is short-lived and limited to exactly what you approve at sign-in.
• Human in the loop for money & sending. Creating a campaign always stops at In Review before any payment or distribution.

Try asking

• "What would 5,000 postcards to my customer list cost?"
• "Set up an EDDM campaign around my store using my Holiday postcard, launching next month — then submit it for review."
• "How did my last mail campaign perform — scans, conversions and ROI by week?"
• "Show me the campaigns I have in review and their launch dates."

Prefer REST?

The same data is available as a plain REST API, scoped to your client with a Bearer key — see Authentication and the API reference, or the machine-readable OpenAPI specification. A live connection guide is also available.