Skip to content
MCP server

SmartRetry Payment Tools

Look up card BINs, issuers, MCCs and decline codes from an AI assistant

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About SmartRetry Payment Tools

SmartRetry Payment Tools is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Four lookups cover the questions that come up when debugging card payments. Give it the first 6 to 8 digits of a card to see network, card type, issuing bank and country; search issuers by partial name; check what a merchant category code means and whether it is flagged high risk; or find out why a payment was declined on Visa, Mastercard, Stripe or Adyen.

It is built to be read-only. A full card number is rejected before anything runs, so only the BIN is ever sent. The site says it logs which tool ran and how long it took, never the question asked. There is no sign-up or API key, with fair-use rate limits.

This is the free public server from SmartRetry, a failed-payment recovery company. Separately, SmartRetry has a platform MCP for its customers, which is not this one.

Install

Run in a terminal

claude mcp add --transport http payment-tools https://tools.mcp.smartretry.com/mcp

Add to Settings → Connectors → Add custom connector

https://tools.mcp.smartretry.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "payment-tools": {
      "url": "https://tools.mcp.smartretry.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "payment-tools": {
      "type": "http",
      "url": "https://tools.mcp.smartretry.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "payment-tools": {
      "serverUrl": "https://tools.mcp.smartretry.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "payment-tools": {
      "type": "http",
      "url": "https://tools.mcp.smartretry.com/mcp"
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

lookup_bin
Card network, type, issuing bank and country from a 6 to 8 digit BIN.
lookup_issuer
Find card issuing banks by name.
lookup_mcc
Merchant category code definitions and high-risk flag.
lookup_decline_code
Explain a card decline code for Visa, Mastercard, Stripe, Adyen and more.

What it does

BIN lookup
Returns card network, type, issuing bank and country from the first 6 to 8 digits.
Issuer search
Finds issuing banks by partial name, with country, website and phone.
MCC definitions
Gives Visa and Mastercard definitions, group and a high-risk flag.
Decline code meanings
Explains declines for Visa, Mastercard, Stripe, Adyen and others.
No key, no login
Open to everyone with fair-use rate limits.
Full numbers rejected
BIN input must be 6 to 8 digits; a complete card number is refused.

Good for

  • Work out why Stripe returned do_not_honor
  • Check the issuing bank behind a card BIN
  • See whether an MCC is classed as high risk
  • Look up a Visa response code such as 51 while triaging declines

Pricing

Free

Free MCP; SmartRetry's recovery service is performance-based

Prices change. Check smartretry.com before you buy.

SmartRetry Payment Tools FAQ

Is it free?

Yes. The free MCP needs no sign-up or API key.

Is a card number ever sent?

No. BIN lookups take 6 to 8 digits and a full card number is rejected before anything runs.

What does SmartRetry log?

Which tool ran and how long it took, never what you asked.

Which clients work?

Any client that speaks MCP over Streamable HTTP, such as Claude, ChatGPT, Cursor, VS Code and Gemini CLI.

Is SmartRetry Payment Tools free?

Yes. SmartRetry Payment Tools is free to use.

How do I add SmartRetry Payment Tools to Claude Code?

Run this command in your terminal: claude mcp add --transport http payment-tools https://tools.mcp.smartretry.com/mcp

What are the best alternatives to SmartRetry Payment Tools?

The closest alternatives to SmartRetry Payment Tools are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to SmartRetry Payment Tools

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools