Integration

Easypromos integration

Easypromos runs online promotions: giveaways, contests, instant win games, quizzes, loyalty and virtual coin programs. This read-only integration lists the account's organizing brands and promotions, and for a promotion its participation stages, registered users (participants), participations with answers and form data, assigned prizes and winners, prize inventory, virtual coin balances and transactions, rankings and points of sale. Participant records carry personal data the promotion collected (names, emails, phones, birthdays, custom registration fields). Not exposed: the participant login token and autologin routes, and every write that needs that token (submitting participations or codes, coin transactions and balance updates, user segments); participants' IP addresses, user agents, avatars and social ids, prize claim form data and prize download, redeem and claim links, and receipt images, store tax ids, addresses and phones are not returned. The REST API is only available on the White Label and Corporate plans. Authentication is an API token from the Easypromos account's Utilities menu, sent as a Bearer token in the Authorization header.

Connect Easypromos How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Easypromos.Built from the 21 Easypromos tools below, on the connection you add once.

What you can do with Easypromos

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

User, 6 operations

get_userGet userGETReturns all registration data of one participant: names, nickname, email, phone, birthday, country, language, status, participation and referral counts, custom fields, segments and consents.
get_user_coin_balanceGet user coin balanceGETReturns a participant's balance of each virtual coin in a promotion.
list_user_coin_transactionsList user coin transactionsGETLists one participant's virtual coin transactions in a promotion (coin, amount, resulting balance, type, reason). Pages with next_cursor.
list_user_participationsList user participationsGETLists one participant's participations in a promotion with stage, points, completion and the answers or form data submitted. Pages with next_cursor.
list_user_prizesList user prizesGETLists the prizes one participant won in a promotion, with prize type, stage, participation and any promotional code. Pages with next_cursor.
list_usersList usersGETLists the users registered in a promotion with their registration data (names, email, phone, birthday, country, custom fields, segments, consents); filter by status. Pages with next_cursor.

Promotion, 3 operations

get_promotionGet promotionGETReturns one promotion: organizing brand, promotion type, title, internal reference, description, status, time zone, start and end dates, default language and public URL.
list_organizing_brand_promotionsList organizing brand promotionsGETLists the promotions of one organizing brand, with type, status, dates and public URL; filter by status. Pages with next_cursor.
list_promotionsList promotionsGETLists the account's promotions (giveaways, contests, games, quizzes) with type, status, dates, time zone and public URL; filter by status. Pages with next_cursor.

Organizing brand, 2 operations

get_organizing_brandGet organizing brandGETReturns one organizing brand: its id and name.
list_organizing_brandsList organizing brandsGETLists the account's organizing brands (every promotion belongs to one). Pages with next_cursor.

Participation, 2 operations

get_participationGet participationGETReturns one participation with its stage, points, completion, submitted answers or form data, requirement code and receipt data, plus the participant and the prize won, if any.
list_participationsList participationsGETLists the participations of a promotion with stage, user, points, completion and the answers or form data submitted (and any code or AI-read receipt). Pages with next_cursor.

Stage, 2 operations

get_stageGet stageGETReturns one participation stage of a promotion: name, description, mechanic type, start and end dates, image, visibility, internal reference and extra metadata.
list_stagesList stagesGETLists the participation stages of a promotion (direct entry, quiz, game, spin the wheel, contest, vote...) with mechanic type, dates and visibility; filter by active or segments.

Coin transaction, 1 operation

list_coin_transactionsList coin transactionsGETLists every virtual coin transaction in a promotion (coin, amount, resulting balance, type, reason) with the participant. Pages with next_cursor.

Inventory, 1 operation

get_prize_inventoryGet prize inventoryGETLists every prize type defined in a promotion with its assignment type, total units and units already given, so remaining stock can be computed.

Po, 1 operation

list_points_of_saleList points of saleGETLists the points of sale (shops that redeem digital coupons in the Vendor Portal) of a promotion with name, group, coordinates and extra properties; filter by group.

Priz, 1 operation

list_prizesList prizesGETLists the prizes assigned in a promotion and their winners, with prize type, stage, participation and any promotional code; filter by prize_type_id. Pages with next_cursor.

Ranking, 1 operation

get_promotion_rankingGet promotion rankingGETReturns the ranking (leaderboard) of a promotion, or of one stage with stage_id: participants ordered by position with their points and registration data; top sets how many (25 by default).

Remaining, 1 operation

get_remaining_participationsGet remaining participationsGETReturns how many participations a user has left in a stage, whether they can participate now and, if not, when they can again. Limits may apply per promotion, day, week or hour.

Use Easypromos from Claude Code, Cursor or Codex

Connect Easypromos in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Easypromos operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Easypromos

Create your workspace
Sign up free. Nothing to install.
Connect Easypromos once
Add your Easypromos connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.