Tipli MCP connector

Tipli is a cashback service. The Tipli MCP connector lets an AI assistant such as Claude search the Tipli catalog: the online shops Tipli lists, the cashback each of them pays and the coupon codes that are valid right now.

Connector URL

https://www.tipli.cz/api/mcp/v1

The connector uses the Streamable HTTP transport. No account, API key or sign-in is needed.

How to add it

  • Claude.ai (Pro and Max): Customize, Connectors, Add custom connector, then paste the URL above.
  • Claude.ai (Team and Enterprise): an organization owner adds it under Organization settings, Connectors.
  • Claude Code: claude mcp add --transport http tipli https://www.tipli.cz/api/mcp/v1

Tools

All tools are read-only. None of them changes anything or needs a Tipli account.

  • tipli_search_shops: Search Tipli shops. Search the shops Tipli lists in one country and read the cashback each advertises to a signed-out visitor. Returns the shop name, its Tipli page, how many valid coupons it has and its categories. Does not return the coupons themselves, which is what tipli_search_deals is for. cashback is null for a shop that currently advertises no rate; for those only cashbackLabel may be quoted. Cashback requires a free Tipli account and a purchase started from the returned url.
  • tipli_get_shop: Get one Tipli shop. Read one shop by its slug: every cashback rate it currently advertises, its description and its live coupons and offers. A shop often pays different rates per product group or per customer type, so cashbackTiers may hold several entries and each carries its own tier name. cashbackTiers is empty when the shop advertises no rate at all.
  • tipli_search_deals: Search Tipli coupons and offers. Search coupon codes and discounts that are valid right now in one country. Expired offers are never returned. code is what the shop page shows in its code box, present only for the coupon type; usually the literal code, but editors sometimes put an instruction there instead, such as that the code arrives by e-mail. validTill is the last day the offer runs; when validTillKnown is false Tipli holds no end date for it. Coupons are separate from cashback, and whether the two can be combined depends on the shop.
  • tipli_list_categories: List Tipli shop categories. The category slugs shops can be filtered by in one country. Call this before passing category to tipli_search_shops: the slugs are in the local language and differ per country.

Countries

Every tool reads one country, chosen by its country argument. Each country is a separate catalog in its own language and currency, and there is no default.

  • bg Bulgaria (tipli.bg, Bulgarian, EUR)
  • cz Czechia (tipli.cz, Czech, CZK)
  • hr Croatia (tipli.hr, Croatian, EUR)
  • hu Hungary (tiplino.hu, Hungarian, HUF)
  • pl Poland (tipli.pl, Polish, PLN)
  • ro Romania (tipli.ro, Romanian, RON)
  • si Slovenia (tipli.si, Slovenian, EUR)
  • sk Slovakia (tipli.sk, Slovak, EUR)

Data

The connector returns only public catalog data, the same a signed-out visitor sees on the Tipli website. Expired coupons are never returned. Cashback is earned through a free Tipli account.

Rate limits

Requests are rate limited per client address. Above the limit the connector answers with HTTP 429 and a Retry-After header that says how long to wait.

Example prompts

  • What cashback does Notino pay through Tipli in the Czech Republic?
  • Find coupon codes that are valid right now on Tipli in Slovakia.
  • Which shop categories does Tipli have in Poland? Show me health and beauty shops with cashback.

Troubleshooting

  • The assistant asks which country you mean: every tool reads one country and there is no default. Name the country you shop in.
  • A shop or category is not found: slugs differ between countries. Let the assistant search the shops or list the categories of that country first.
  • The connector answers HTTP 429: the client went over the rate limit. Wait as long as the Retry-After header says.
  • The connector shows no tools: check that the URL is exactly the one above. It answers POST requests only.
  • Cashback was not credited: it needs a free Tipli account and a purchase started from the Tipli shop page the connector links to.

Privacy

How the connector handles data is described in the Tipli MCP connector privacy policy.

Support

Questions and problems: moje@tipli.cz