Integration · Marketing

Connect Claude & ChatGPT to Easypromos

Ask your AI how a promotion is going in Easypromos. It can list your promotions and organizing brands, see who registered and how they took part, and show which prizes were given out and to whom. It can also read the leaderboard, the prize stock and each user's virtual coin balance and transactions.

Connect Easypromos free

Free plan, no credit card. Takes about a minute.

Try asking

“Which promotions are running right now?”
The AI lists your promotions filtered by status, with their IDs and basic details.
“Who won prizes in the summer giveaway?”
It lists the prizes assigned in that promotion and their winners.
“Show the top 10 on the leaderboard for the quiz.”
It reads the promotion's ranking with a limit of 10, optionally for one stage.

What your AI can do

Promotions and brands

List promotions by status, read their details and stages, and see the promotions of each organizing brand.

Users and participations

See registered users, their data and participations, and how many participations a user has left.

Prizes, rankings and coins

See prizes and winners, prize stock, leaderboards, and virtual coin balances and transactions.

“How many prizes do we have left in stock?”
It reads the promotion's prize inventory.
“How many times has user 4711 taken part, and how many tries are left?”
It lists the user's participations and checks how many participations remain in the stage.
“What is Anna's coin balance, and where did her coins come from?”
It reads her virtual coin balance and lists her coin transactions in the promotion.

20 tools for Easypromos

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

get_organizing_brandGet one organizing brand by `organizing_brand_id`.
get_participationGet one participation. Pass `promotion_id` and `participation_id`.
get_prize_inventoryGet the prize inventory (stock) of a promotion by `promotion_id`.
get_promotionGet the basic details of one promotion by `promotion_id`.
get_rankingGet the leaderboard of a promotion by `promotion_id`, optionally for one `stage_id`, with `limit`.
get_remaining_participationsGet how many participations a user has left in a stage. Pass `promotion_id`, `stage_id` and `user_id`.
get_stageGet all data of one participation stage. Pass `promotion_id` and `stage_id`.
get_userGet all data of one registered user. Pass `promotion_id` and `user_id`.
get_user_coin_balanceGet a user's virtual coin balance in a promotion. Pass `promotion_id` and `user_id`.
list_brand_promotionsList the promotions of one organizing brand by `organizing_brand_id`, optionally filtered by `status`.
list_coin_transactionsList all virtual coin transactions in a promotion by `promotion_id`.
list_organizing_brandsList the organizing brands in the account.
list_participationsList all participations in a promotion by `promotion_id`. Paginate with `next_cursor`.
list_prizesList the prizes assigned in a promotion and their winners by `promotion_id`, optionally filtered by `prize_type_id`.
list_promotionsList the account's promotions, optionally filtered by `status`. Paginate with `next_cursor`.
list_stagesList the participation stages of a promotion by `promotion_id`, optionally only `active` ones.
list_user_coin_transactionsList the virtual coin transactions of one user. Pass `promotion_id` and `user_id`.
list_user_participationsList the participations of one user in a promotion. Pass `promotion_id` and `user_id`.
list_user_prizesList the prizes won by one user. Pass `promotion_id` and `user_id`.
list_usersList the users registered in a promotion by `promotion_id`. Paginate with `next_cursor`.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Easypromos from the app list.
2
Paste your key
Paste an Easypromos API token. API access requires a White Label or Corporate plan. In your Easypromos account open the Utilities menu, generate an API token and copy it.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Easypromos?

It can list and read promotions, organizing brands and participation stages, list registered users and read their data, and list participations for a promotion or one user. It can also check remaining participations, list prizes and winners, read prize inventory and rankings, and read virtual coin balances and transactions. It reads data only.

Does the AI see my Easypromos credentials?

No. Your Easypromos API token is encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on. All Easypromos tools read data and do not change anything in your promotions. Every tool call is logged, so you can see what was looked up.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Easypromos account on a plan with API access (White Label or Corporate).

Which Easypromos plan do I need?

Easypromos gives API access on the White Label and Corporate plans. With one of those, you generate the API token from the Utilities menu in your account and paste it into PipMCP.