couponapi

aigeon-ai/couponapi

3.5

couponapi is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.

If you are the rightful owner of couponapi and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

CouponAPI provides access to a variety of coupon offers, allowing users to retrieve, filter, and obtain detailed information about current promotions.

Try couponapi with chat:

Server config via mcphub

Tools
4
Resources
0
Prompts
0

Couponapi

Introduction

Welcome to the CouponAPI! This MCP provides access to a variety of coupon offers, allowing users to retrieve, filter, and obtain detailed information about current promotions. With our API, you can easily access incremental feeds of coupon offers, get details for specific offers, and filter offers by store or category. This documentation outlines the available endpoints and their functionalities.

Tools Overview

1. get_incremental_feed

  • Name: get_incremental_feed
  • Description: Retrieve an incremental feed of coupon offers from CouponAPI.org. This endpoint returns new, updated, and suspended offers since the last extract time. If no last_extract is provided, it returns all currently active offers. Set off_record=True to avoid updating the last extract time in the system.
Input Schema
  • last_extract: Last extract timestamp as UNIX timestamp in seconds (epoch). If not provided, returns all active offers.
  • response_format: Response format: 'json' or 'csv'. Defaults to 'json'.
  • limit: Maximum number of offers to return. Optional parameter.
  • store_id: Filter by specific store ID. Optional parameter.
  • category: Filter by category. Optional parameter.
  • off_record: When True, does not update the last extract time, allowing repeated retrieval of incremental data. Defaults to False.

2. get_offer_details

  • Name: get_offer_details
  • Description: Retrieve detailed information for a specific offer. This tool filters the incremental feed to return details for a specific offer ID.
Input Schema
  • offer_id: The unique offer ID to get details for. (Required)

3. get_offers_by_store

  • Name: get_offers_by_store
  • Description: Retrieve all offers for a specific store. This endpoint returns all current offers for the specified store name.
Input Schema
  • store_name: Store name to filter offers by. (Required)

4. get_offers_by_category

  • Name: get_offers_by_category
  • Description: Retrieve all offers for a specific category. This endpoint returns all current offers for the specified category.
Input Schema
  • category: Category to filter offers by. (Required)