AI assistants (MCP)
Connect Claude, Claude Code, Cursor or any MCP client to Evendeals to read analytics and manage country discounts and campaigns in plain language.
Evendeals runs a remote Model Context Protocol (MCP) server. Connect your AI assistant once, then ask things like:
- "Which countries send traffic but have no discount yet?"
- "How did my deals do in the last 30 days, by country?"
- "Set India and Brazil to 60% on my course deal."
- "Create a Black Friday campaign: 40% everywhere, Nov 28 to Dec 1, New York time."
- "Why isn't my banner showing for visitors from Germany?"
It's available on every plan.
Server URL
https://www.evendeals.com/api/mcpStreamable HTTP. You sign in with your Evendeals account (OAuth), pick the organization, and approve access. No API key to copy.
Connect
Claude (claude.ai and Claude Desktop)
- Open Settings → Connectors → Add custom connector.
- Name it
Evendealsand paste the server URL. - Click Connect, sign in to Evendeals and approve.
Claude Code
claude mcp add --transport http evendeals https://www.evendeals.com/api/mcpThen run /mcp, choose evendeals and authenticate in the browser.
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), then click Connect next to Evendeals in Cursor's MCP settings:
{
"mcpServers": {
"evendeals": { "url": "https://www.evendeals.com/api/mcp" }
}
}Other clients
Any client that supports remote MCP servers with OAuth works. Discovery follows the MCP spec: GET /.well-known/oauth-protected-resource/api/mcp points to the authorization server, which supports dynamic client registration, PKCE and refresh tokens.
Permissions
| Who connects | Can read | Can change things |
|---|---|---|
| Owner or admin (OAuth) | ✓ | ✓ (if approved on the consent screen) |
| Member (OAuth) | ✓ | – |
| Organization API key | ✓ | – |
Access is tied to the organization you pick when connecting. To use another organization, connect again and switch on the consent screen. Removing someone from the team cuts their access on the next request.
Read-only with your API key
For scripts or clients without OAuth, send your organization API key (Dashboard → Developers). API-key access is always read-only.
claude mcp add --transport http evendeals https://www.evendeals.com/api/mcp \
--header "x-api-key: YOUR_API_KEY"Tools
Read
| Tool | What it does |
|---|---|
get_account | Organization, plan, your role, banner lookups used vs limit, counts |
list_products | Products (sites or stores) with currency and provider |
list_deals | Deals with type, active/paused, provider health, banner last seen |
get_deal | One deal's settings: VPN blocking, coupon duration and rotation, display modes, timer, allowed URLs |
list_country_discounts | Discount per parity group and per-country overrides, with coupon codes, views and redemptions |
get_analytics | Lookups, visitors, coverage, top countries and pages, coupon and campaign results, uncovered countries |
list_campaigns | Campaigns with status, schedule, discounts and sync status |
preview_offer | What a visitor from a given country sees right now |
Write
| Tool | What it does |
|---|---|
update_country_discounts | Set or remove discounts for parity groups or countries; creates the checkout coupons on connected providers |
set_deal_active | Pause or resume a deal |
upsert_campaign | Create or edit a campaign (new ones start as drafts) |
set_campaign_status | Put a campaign live or pause it |
rotate_coupons | Replace a deal's coupon codes with fresh ones |
Write tools change live checkout coupons, so your assistant should confirm amounts with you first. Plan limits still apply: campaigns need Pro, coupon rotation needs a paid plan. Creating deals, connecting payment providers, billing and team settings stay in the dashboard.
Limits
120 requests per minute per organization. Over the limit, the server answers 429 with Retry-After.
Disconnect
Remove the connector in your AI client. Access tokens expire after an hour; refresh stops working once you remove the app or leave the organization.