Pagos Official Mcp Server

What is Pagos Official Mcp Server about?

The server enables retrieval of BIN (Bank Identification Number) information using the Pagos API. Users can request basic BIN details or, by enabling the enhanced mode, obtain richer insights such as additional attributes and analytics.

How to use Pagos Official Mcp Server?

Install UV (recommended package manager for Python projects):
```
brew install uv   # macOS example
```

Clone the repository:

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

Run the server (example for Claude Desktop integration):

{
  "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"
      }
    }
  }
}

Set ENHANCED_BIN_DATA to "false" for basic responses.

Key Features of Pagos Official Mcp Server

BIN lookup: Retrieve issuer information for any BIN number.
Enhanced data option: Toggle richer data sets via the ENHANCED_BIN_DATA flag.
Simple configuration: Uses environment variables for API key and data mode.
Lightweight: Runs with UV/Python without heavy dependencies.

Use Cases of Pagos Official Mcp Server

Fraud prevention: Validate card origins during transaction processing.
Compliance: Gather issuer details to meet regulatory reporting.
Analytics: Enrich transaction data with demographic or risk attributes.
Customer support: Quickly identify card type and issuing bank for service agents.

FAQ from the Pagos Official Mcp Server

Q: Do I need a paid contract for enhanced BIN data? A: Yes, check your Pagos contract for any additional costs before enabling ENHANCED_BIN_DATA.

Q: What happens if ENHANCED_BIN_DATA is omitted? A: The server defaults to basic BIN data ("false").

Q: Which environment variable holds the API key? A: PAGOS_API_KEY.

Q: Can I run the server on Windows? A: Yes, install UV for Windows and follow the same clone‑run steps.

Q: Is there a rate limit for BIN queries? A: Rate limits are defined by your Pagos API agreement; refer to the Pagos documentation.

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"
            }
        }
    }
}

Pagos Official Mcp Server