# SmartRetry Payment Tools

> SmartRetry Payment Tools is a free MCP server for finance and payments. Look up card BINs, issuers, MCCs and decline codes from an AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://www.smartretry.com/mcp
- **MCP Registry name:** com.smartretry/payment-tools
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tools.mcp.smartretry.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "payment-tools": {
      "url": "https://tools.mcp.smartretry.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/smartretry-payment-tools
