Decide

You can query four MCP endpoints from decide.fyi to deterministically assess refund eligibility, cancellation penalties, return eligibility, and trial terms for US consumers. This MCP setup is stateless, free to use, and requires no authentication, making it easy to integrate with client applications and automated workflows.

How to use

Connect your MCP client to the four available endpoints to perform subscription-related checks. Configure the client to point to the refund, cancel, return, and trial MCP endpoints, and use the provided input fields to obtain structured verdicts and codes that guide user-facing decisions.

How to install

Prerequisites you need before installing include a modern runtime environment with Node.js and npm or npx available on your system.

Step 1: Prepare your environment. Ensure Node.js is installed and accessible from your command line.

Step 2: Connect to the MCP endpoints by providing the following MCP configuration to your client. This config enables your client to reach all four servers from decide.fyi.

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

Additional setup and checks

Step 3: Start the local development environment if you want to run checks locally. Use the following command to start a local dev server that serves MCP endpoints in a development-like environment.

npx vercel dev

Local validation steps you can run

In a separate terminal, you can run basic checks for handler logic and MCP endpoints once the local server is running.

# Handler-level smoke checks (no running server required)
npm run smoke

# MCP endpoint checks (requires vercel dev running on localhost:3000)
npm run mcp:check

Available tools

refund_eligibility

Checks if a subscription purchase falls within the vendor's defined refund window and returns a verdict with details like within window, outside window, or unsupported vendor.

cancellation_penalty

Determines if cancellation incurs penalties such as early termination fees or contract locks, or if cancellation is free.

return_eligibility

Assesses if a purchase is returnable, including the type of return and any applicable window or method.

trial_terms

Checks availability and terms of a free trial, including duration, card requirement, and auto-conversion status.