Pagos Official MCP Server

What is Pagos Official MCP Server about?

The server exposes a single capability: retrieve information for a given Bank Identification Number (BIN) using the Pagos API. It can return basic BIN details or an enriched set of attributes when the ENHANCED_BIN_DATA flag is set to true.

How to use Pagos Official MCP Server?

1. Install uv (the Python package manager) – on macOS: brew install uv.
2. Clone the repository:

   git clone https://github.com/pagos-ai/pagos-mcp.git
   

3. Configure the MCP server in Claude Desktop (or any MCP‑compatible client) by pointing to the script and supplying environment variables:

   {
     "mcpServers": {
       "bin-data": {
         "command": "uv",
         "args": ["--directory", "</path/to/pagos-mcp-server>", "run", "pagos-mcp-server.py"],
         "env": {
           "PAGOS_API_KEY": "<your-pagos-api-key>",
           "ENHANCED_BIN_DATA": "true"
         }
       }
     }
   }
   

4. Start the MCP server through the client; it will listen for BIN lookup requests.

Key Features

• Single‑purpose BIN lookup via a simple request/response model.
• Enhanced data toggle (ENHANCED_BIN_DATA) to control response richness.
• Secure API key handling through environment variables.
• Minimal footprint – only a Python script and uv runtime needed.

Use Cases

• Fraud detection systems needing quick BIN validation.
• Payment processors that want to enrich transaction data with issuer details.
• Market research tools analyzing card‑type distributions.
• Mobile or web apps that display card brand information during checkout.

FAQ

Q: Do I need a paid Pagos subscription? A: Yes, an API key is required; consult your contract for pricing, especially for enhanced BIN calls.

Q: What format is the response? A: JSON containing standard BIN fields (bank name, card scheme, country, etc.) and, when enhanced, additional insights such as merchant category, risk scores, and processing limits.

Q: Can I run the server on Linux or Windows? A: The repository is platform‑agnostic; install uv for your OS and follow the same steps.

Q: How do I switch between basic and enhanced data? A: Set the ENHANCED_BIN_DATA environment variable to "true" or "false" before launching the server.

Q: What if I exceed my API quota? A: The server will forward the error from Pagos; monitor usage and adjust your plan as needed.

Pagos Data MCP Server

Capabilities

• Get BIN data for a given BIN number.

Configuration

Pagos API Key

Follow the instructions in the Pagos API Key documentation to create an API key.

Enhanced BIN Data

Set to "true" for enhanced BIN response attributes which will provide the richest insights on the BIN. Set to "false" for basic BIN data. Defaults to "false" if value is not provided. Check your contract for any additional costs associated with enhanced bin data calls before setting to "true".

Clone the repository locally and install uv

On MacOs, install uv with Homebrew:

brew install uv

Clone the repository:

git clone https://github.com/pagos-ai/pagos-mcp.git

Add the MCP Server to Desktop Claude

On MacOs, update config file ~/Library/Application\ Support/Claude/claude_desktop_config.json and update elements with your systems specific values.

{
    "mcpServers": {
        "bin-data": {
            "command": "uv",
            "args": [
                "--directory",
                "</path/to/pagos-mcp-server>",
                "run",
                "pagos-mcp-server.py"
            ],
            "env": {
                "PAGOS_API_KEY": "<your-pagos-api-key>",
                "ENHANCED_BIN_DATA": "true"
            }
        }
    }
}