Give Your AI Assistant Real Coupon Search with an Open MCP Server

Most shopping assistants can only suggest searching for coupons. But what if your assistant could find real offers for you? This article will guide you through connecting the MCP server to your AI assistant so you can access live coupon offers without needing an account or API key.

What is SecretPass?

SecretPass is a shopping club that provides coupon codes and deals for online shopping in the United States, the United Kingdom, and Australia. With the MCP server, you can make your AI assistant smarter by allowing it to look up real offers.

What the MCP Server Does

The MCP server is available at https://secretpass.com/mcp. It operates over HTTP and does not require authentication. Here are the three main tools you can use:

• search_offers: This tool allows you to search for offers using keywords, regions, categories, shops, brands, or product types.
• get_offer: Use this tool to retrieve full public details of a specific offer.
• list_filters: This tool lists available countries, categories, brands, and product types along with their offer counts.

How to Connect the MCP Server to Your Assistant

Step 1: Set Up the MCP Server

You can connect the MCP server to your AI assistant by following these steps:

For Claude:

claude mcp add --transport http secretpass https://secretpass.com/mcp

For Cursor, you need to modify the mcp.json file. Add the following:

{
  "mcpServers": {
    "secretpass": {
      "url": "https://secretpass.com/mcp"
    }
  }
}

Step 2: Make a Request to Search for Offers

You can ask your assistant to find offers by using a command like this: "Find current shoe offers in the US and compare the savings."

Step 3: Call the MCP Server Directly

If you want to test the MCP server directly, you can use the following curl command:

curl -s -X POST https://secretpass.com/mcp \  
-H 'Content-Type: application/json' \  
-H 'Accept: application/json, text/event-stream' \  
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"search_offers", "arguments":{"query":"shoes","region":"us","limit":2}}}'

Step 4: Understand the Offer Data

Each offer returned will come as structured data. Here’s an example of what a single offer might look like:

{
  "id": "us/48237228",
  "business": "Marion Parke",
  "title": "New pre-fall footwear",
  "region": "us",
  "category_name": "Retail Gifts",
  "offer_display": {
    "product_type": "Shoes",
    "features": ["15% off the first order."]
  },
  "expires_at": null,
  "url": "https://secretpass.com/offer-item/us/48237228",
  "membership_required_to_unlock": true
}

Keep in mind that offers can change or expire, so it’s wise to check the expires_at field and show users the offer page instead of promising a saving.

Tips for Using the MCP Server

• List Filters: Start by calling list_filters if you need specific brand or product type values.
• Pagination: Use limit and next_offset to navigate through results.
• Get Offer Details: Use get_offer with an offer ID to read the conditions before comparing offers.

For more detailed information, you can check the full documentation at secretpass.com/mcp-api-docs.

Conclusion

With the SecretPass MCP server, you can enhance your AI assistant's capabilities to provide real-time coupon searches. This integration opens up a new world of possibilities for smarter shopping.

Merits

• Enables real-time coupon search.
• No account or API key required.
• Supports multiple countries and categories.

Demerits

• Offers may change or expire quickly.
• Membership may be required to unlock some codes.

Caution

This article is for educational purposes. Remember to replace any placeholder values with your actual data when implementing. Always verify claims against the original source before relying on them.

Frequently asked questions

• What is the MCP server? — The MCP server allows AI assistants to access real-time coupon offers without needing an account or API key.
• How do I connect to the MCP server? — You can connect by adding the server URL to your assistant's configuration file or using a command.
• What tools are available on the MCP server? — The server offers tools to search for offers, get offer details, and list filters.
• Is there a cost to use the MCP server? — Accessing the server is free, but some offers may require a membership to unlock codes.
• Can I use the MCP server without programming skills? — Basic commands can be executed without programming skills, but some configuration may require technical knowledge.
• What types of offers can I find? — You can find offers based on various criteria like keywords, region, and product type.

Tags

#ai #api #mcp #coupons #shopping #offers #integration #technology