SmartRetry Payment Tools
Free BIN, issuer, MCC and decline code lookups for card payments (Visa, Mastercard, Stripe, Adyen).
Hosted MCP Server
npx add-mcp 'https://tools.mcp.smartretry.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Payments MCP server for AI assistants
Free BIN, MCC, issuer and decline code lookups in Claude and ChatGPT.
https://tools.mcp.smartretry.com/mcpCopy
A real answer from the server, shortened. What is code 51? Visa 51: Not sufficient funds. An issuer response code. Source: SmartRetry.


Connect Claude, ChatGPT, Cursor and more
Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI and any client that speaks MCP over Streamable HTTP.
Claude and Claude CodeChatGPT and CodexCursorVS CodeGemini CLIAny MCP client
Claude
On the web or desktop, open Settings, then Connectors, and add a custom connector with this URL.
https://tools.mcp.smartretry.com/mcpCopy
Claude Code
Run this once in your terminal.
claude mcp add --transport http smartretry-tools https://tools.mcp.smartretry.com/mcpCopy
ChatGPT
Turn on developer mode in Settings, under Apps and Connectors. Then create a connector with this URL and no authentication.
https://tools.mcp.smartretry.com/mcpCopy
Codex
Run this once in your terminal.
codex mcp add smartretry-tools --url https://tools.mcp.smartretry.com/mcpCopy
Cursor
Install it in one click, or add it to ~/.cursor/mcp.json yourself.
{ "mcpServers": { "smartretry-tools": { "url": "https://tools.mcp.smartretry.com/mcp" } } }Copy
VS Code
Install it in one click for GitHub Copilot, or add it to .vscode/mcp.json.
{ "servers": { "smartretry-tools": { "type": "http", "url": "https://tools.mcp.smartretry.com/mcp" } } }Copy
Gemini CLI
Add it to ~/.gemini/settings.json.
{ "mcpServers": { "smartretry-tools": { "httpUrl": "https://tools.mcp.smartretry.com/mcp" } } }Copy
Any MCP client
Point any client that supports Streamable HTTP at this URL. No login or API key.
{ "mcpServers": { "smartretry-tools": { "url": "https://tools.mcp.smartretry.com/mcp" } } }Copy
Four payment lookups your AI can call
-
lookup_binBIN lookup
Card network, card type, issuing bank and country from the first 6 to 8 digits. Open the BIN Lookup
“ Which bank issued card BIN 424242? ”
Card: VISA CREDIT (CLASSIC)Issuing bank: STRIPE PAYMENTS UK, LTD.Country: United Kingdom (GB) -
lookup_issuerIssuer lookup
Card issuing banks by name, with country, website and phone. Partial names work. Open the Issuer Lookup
“ Find the card issuers called Barclays. ”
BARCLAYS BANK S.A.E.: Spain (ES)BARCLAYS BANK PLC, HAMBURG: Germany (DE) -
lookup_mccMCC lookup
Merchant category codes: Visa and Mastercard definitions, group and high-risk flag. Open the MCC Lookup
“ What is MCC 5411, and is it high risk? ”
MCC 5411: Grocery Stores and SupermarketsGroup: Retail outletsHigh risk: no -
lookup_decline_codeDecline code lookup
Why a card payment was declined, for Visa, Mastercard, Stripe, Adyen and more. Open the Decline Code Lookup
“ What does do_not_honor mean on Stripe? ”
Stripe do_not_honor: The card was declined for an unknown reason.Customer must contact their card issuer.
Read-only by design. It never needs a card number.
- BIN lookups take 6 to 8 digits. A full card number is rejected before anything runs.
- We log which tool ran and how long it took, never what you asked.
- No sign-up, no API key, no account. Fair-use rate limits keep it quick.
MCP server questions
What is the SmartRetry Payment Tools MCP server?
A free, public MCP server at https://tools.mcp.smartretry.com/mcp. It lets AI assistants such as Claude, ChatGPT and Cursor look up a card BIN, an issuing bank, a merchant category code (MCC) or a payment decline code, from SmartRetry’s payment data.
Which AI assistants does it work with?
Any client that supports MCP over Streamable HTTP, including Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code with GitHub Copilot and Gemini CLI.
How do I add it to Claude?
In Claude, open Settings, then Connectors, choose Add custom connector and paste https://tools.mcp.smartretry.com/mcp. No login or API key is needed.
How do I add it to ChatGPT?
Turn on Developer Mode in ChatGPT under Settings > Apps & Connectors. Then create a connector with https://tools.mcp.smartretry.com/mcp and choose no authentication.
Is it free?
Yes. It is open to everyone, with no sign-up, login, or API key. Fair-use rate limits keep it fast for everyone.
Does it store my questions or card numbers?
No. It never accepts a full card number: BIN lookups take only the first 6 to 8 digits. It logs which tool ran and how long it took, not what you asked.
Can it see my transactions?
No. It reads public payment reference data only. SmartRetry customers can get the Platform MCP, with their own transaction data and insights, through their account manager.
Need it on your own payments?
Everything on this page is our free MCP, open to everyone, for our free tools.
SmartRetry Platform MCP
For SmartRetry customers: our internal tools, your transaction data and insights on it, in your AI assistant. Already a customer? Ask your account manager for access.
Not a customer yet? See pricing
Any other question? Contact us
{"@context":"https://schema.org","@type":"WebPage","name":"Payment Tools MCP Server: BIN, MCC & Decline Codes | SmartRetry","description":"Free MCP server for Claude, ChatGPT and Cursor: BIN, issuing bank, MCC and decline code lookups for card payments. No login, read-only.","url":"https://www.smartretry.com/mcp","dateModified":"2026-11-03T10:00:30.000Z","author":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}},"isPartOf":{"@type":"WebSite","@id":"https://www.smartretry.com/#website","name":"SmartRetry","url":"https://www.smartretry.com","description":"Payment recovery guides, tools and reference data from SmartRetry - failed payment recovery, false decline prevention and authorization rate optimization.","inLanguage":"en","publisher":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}}},"mainEntity":{"@type":"SoftwareApplication","@id":"https://www.smartretry.com/mcp#mcp-server","name":"SmartRetry Payment Tools MCP server","alternateName":"smartretry-tools","description":"A free, public MCP server at https://tools.mcp.smartretry.com/mcp. It lets AI assistants such as Claude, ChatGPT and Cursor look up a card BIN, an issuing bank, a merchant category code (MCC) or a payment decline code, from SmartRetry's payment data.","applicationCategory":"DeveloperApplication","applicationSubCategory":"Model Context Protocol (MCP) server","operatingSystem":"Any MCP client (Claude, ChatGPT, Cursor, VS Code, Claude Code, Gemini CLI)","url":"https://www.smartretry.com/mcp","installUrl":"https://tools.mcp.smartretry.com/mcp","softwareVersion":"1.0.0","featureList":["BIN lookup (lookup_bin): Card network, card type, issuing bank and country from the first 6 to 8 digits.","Issuer lookup (lookup_issuer): Card issuing banks by name, with country, website and phone. Partial names work.","MCC lookup (lookup_mcc): Merchant category codes: Visa and Mastercard definitions, group and high-risk flag.","Decline code lookup (lookup_decline_code): Why a card payment was declined, for Visa, Mastercard, Stripe, Adyen and more."],"keywords":"MCP server, payments MCP, BIN lookup MCP, decline code MCP, MCC lookup, issuer lookup, Claude connector, ChatGPT connector, Cursor MCP, SmartRetry","provider":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}},"isAccessibleForFree":true,"offers":{"@type":"Offer","price":"0","priceCurrency":"USD","availability":"https://schema.org/InStock"}}}
{"@context":"https://schema.org","@type":"HowTo","name":"How to add the SmartRetry Payment Tools MCP server to your AI assistant","description":"Connect https://tools.mcp.smartretry.com/mcp to Claude, ChatGPT, Cursor or any MCP client. No login or API key.","totalTime":"PT2M","tool":["Claude","Claude Code","ChatGPT","Codex","Cursor","VS Code","Gemini CLI","Any MCP client"],"step":[{"@type":"HowToStep","name":"Add it to Claude","text":"On the web or desktop, open Settings, then Connectors, and add a custom connector with this URL. https://tools.mcp.smartretry.com/mcp","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to Claude Code","text":"Run this once in your terminal. claude mcp add --transport http smartretry-tools https://tools.mcp.smartretry.com/mcp","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to ChatGPT","text":"Turn on developer mode in Settings, under Apps and Connectors. Then create a connector with this URL and no authentication. https://tools.mcp.smartretry.com/mcp","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to Codex","text":"Run this once in your terminal. codex mcp add smartretry-tools --url https://tools.mcp.smartretry.com/mcp","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to Cursor","text":"Install it in one click, or add it to ~/.cursor/mcp.json yourself.","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to VS Code","text":"Install it in one click for GitHub Copilot, or add it to .vscode/mcp.json.","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to Gemini CLI","text":"Add it to ~/.gemini/settings.json.","url":"https://www.smartretry.com/mcp#connect"},{"@type":"HowToStep","name":"Add it to Any MCP client","text":"Point any client that supports Streamable HTTP at this URL. No login or API key.","url":"https://www.smartretry.com/mcp#connect"}]}
{"@context":"https://schema.org","@type":"ItemList","name":"Tools in the SmartRetry Payment Tools MCP server","numberOfItems":4,"itemListElement":[{"@type":"ListItem","position":1,"name":"BIN lookup (lookup_bin)","description":"Card network, card type, issuing bank and country from the first 6 to 8 digits.","url":"https://www.smartretry.com/bin"},{"@type":"ListItem","position":2,"name":"Issuer lookup (lookup_issuer)","description":"Card issuing banks by name, with country, website and phone. Partial names work.","url":"https://www.smartretry.com/issuer"},{"@type":"ListItem","position":3,"name":"MCC lookup (lookup_mcc)","description":"Merchant category codes: Visa and Mastercard definitions, group and high-risk flag.","url":"https://www.smartretry.com/mcc"},{"@type":"ListItem","position":4,"name":"Decline code lookup (lookup_decline_code)","description":"Why a card payment was declined, for Visa, Mastercard, Stripe, Adyen and more.","url":"https://www.smartretry.com/decline-code"}]}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.smartretry.com/"},{"@type":"ListItem","position":2,"name":"MCP Server","item":"https://www.smartretry.com/mcp"}]}
{"@context":"https://schema.org","@type":"FAQPage","author":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}},"mainEntity":[{"@type":"Question","name":"What is the SmartRetry Payment Tools MCP server?","acceptedAnswer":{"@type":"Answer","text":"A free, public MCP server at https://tools.mcp.smartretry.com/mcp. It lets AI assistants such as Claude, ChatGPT and Cursor look up a card BIN, an issuing bank, a merchant category code (MCC) or a payment decline code, from SmartRetry’s payment data."}},{"@type":"Question","name":"Which AI assistants does it work with?","acceptedAnswer":{"@type":"Answer","text":"Any client that supports MCP over Streamable HTTP, including Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code with GitHub Copilot and Gemini CLI."}},{"@type":"Question","name":"How do I add it to Claude?","acceptedAnswer":{"@type":"Answer","text":"In Claude, open Settings, then Connectors, choose Add custom connector and paste https://tools.mcp.smartretry.com/mcp. No login or API key is needed."}},{"@type":"Question","name":"How do I add it to ChatGPT?","acceptedAnswer":{"@type":"Answer","text":"Turn on Developer Mode in ChatGPT under Settings > Apps & Connectors. Then create a connector with https://tools.mcp.smartretry.com/mcp and choose no authentication."}},{"@type":"Question","name":"Is it free?","acceptedAnswer":{"@type":"Answer","text":"Yes. It is open to everyone, with no sign-up, login, or API key. Fair-use rate limits keep it fast for everyone."}},{"@type":"Question","name":"Does it store my questions or card numbers?","acceptedAnswer":{"@type":"Answer","text":"No. It never accepts a full card number: BIN lookups take only the first 6 to 8 digits. It logs which tool ran and how long it took, not what you asked."}},{"@type":"Question","name":"Can it see my transactions?","acceptedAnswer":{"@type":"Answer","text":"No. It reads public payment reference data only. SmartRetry customers can get the Platform MCP, with their own transaction data and insights, through their account manager."}}]}