home / mcp / pagos data mcp server

Pagos Data MCP Server

Provides BIN data for a given BIN number with optional enhanced data and easy MCP integration.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ampcome-mcps-pagos-mcp": {
      "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 Data MCP Server provides access to BIN data by querying a BIN number. It’s useful for applications that need quick, programmatic BIN insights and the ability to toggle enhanced data for richer attributes when your contract allows it.

How to use

You interact with the Pagos Data MCP Server through an MCP client to fetch BIN information for a specific BIN number. Start by ensuring your API key is configured, and set enhanced BIN data if you need richer insights. Your MCP client will request data from the server using the standard MCP workflow, and you’ll receive BIN attributes such as issuer details, card type, and country information based on the selected data mode.

How to install

Prerequisites: you need a Unix-like environment with Python installed. You also install the UV tool to run MCP servers locally.

# Install UV (MacOS via Homebrew)
brew install uv

# Clone the MCP repository
git clone https://github.com/pagos-ai/pagos-mcp.git

# Navigate to the cloned directory (path to pagos-mcp-server should point to the server folder inside the clone)
cd pagos-mcp

Additional setup for local MCP server start

Configure your local run using UV to load the server from your cloned repository. The following start command runs the payments MCP server from the local directory with the required 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"
      }
    }
  }
}

Available tools

get_bin_data

Fetches BIN data for a given BIN number with optional enhanced data to provide richer BIN attributes.