Pagos

Queries BIN data via Pagos API with optional enhanced attributes for richer BIN insights.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pagos-ai-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"
      }
    }
  }
}

You can query BIN data directly from Pagos using an MCP server that runs locally and exposes a simple runtime to fetch standard or enhanced BIN information. This server accepts a BIN number and returns data with configurable detail levels, making it easy to integrate BIN lookups into your workflows or apps.

How to use

Run the MCP server locally and connect your MCP client to it. The server can return basic BIN data or enhanced data with richer attributes when enabled. Start the server, then provide the BIN number you want to look up through your MCP client to receive the corresponding data.

How to install

Prerequisites: you need Python installed on your machine and the ability to install the uv runner as a local tool.

Install uv on MacOS (or ensure it is available on your system) using Homebrew.

brew install uv

Clone the MCP server repository where the pagos-mcp-server script resides.

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

Place the MCP server in a local directory and prepare your environment. You will set your Pagos API key and the enhanced BIN data flag for enriched responses.

PAGOS_API_KEY=<your-pagos-api-key> 
ENHANCED_BIN_DATA=true

Start the MCP server using uv. Replace </path/to/pagos-mcp-server> with the actual path to the local copy of pagos-mcp-server.

uv --directory </path/to/pagos-mcp-server> run pagos-mcp-server.py

Add the MCP Server to Desktop Claude on MacOS

If you use the Claude desktop app, add the MCP server as a local stdio process by editing the Claude configuration to point to the local server path and 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

Retrieves BIN data for a provided BIN number; supports enhanced data when ENHANCED_BIN_DATA is set to true.