Pagos

Pagos

Interact with the Pagos API. Query Credit Card BIN Data with more to come.

1
Stars
2
Forks
0
Releases

Overview

The Pagos Data MCP Server enables retrieval of BIN data for a supplied BIN number by interfacing with the Pagos API. It supports basic BIN lookups and an enhanced BIN data mode that returns richer attributes when enabled. To use, provide a Pagos API key and configure the ENHANCED_BIN_DATA flag to true or false. The server can be run locally using uv (a command-line tool) and is configured via environment variables, including PAGOS_API_KEY and ENHANCED_BIN_DATA, with ENHANCED_BIN_DATA defaulting to false if not provided. Deployment steps include cloning the repository, installing uv, and running the MCP server with the appropriate command. Integration with Desktop Claude is demonstrated by adding the MCP server to claude_desktop_config.json, which specifies the command, arguments, and environment variables. Remember to review your Pagos contract for any costs associated with enhanced BIN data calls. This MCP server focuses on BIN data retrieval and configuration to tailor the level of detail returned by the API.

Details

Owner
pagos-ai
Language
Python
License
Updated
2025-12-07

Features

BIN data retrieval

Fetch BIN data for a provided BIN number from the Pagos API.

Enhanced BIN data option

Enable richer BIN attributes by setting ENHANCED_BIN_DATA to true; basic data when false; defaults to false.

API key authentication

Requires a valid Pagos API key (PAGOS_API_KEY) to access the data.

Configurable via environment variables

Configure API key and data enhancement via environment variables, with default behaviors.

Local deployment with uv

Run the MCP server locally using uv and the provided run command.

Claude Desktop integration

Demonstrates adding the MCP server to Desktop Claude with a sample configuration.

Audience

DeveloperBuilds or integrates BIN data queries via Pagos API.
Data EngineerAutomates BIN data lookups and data enrichment pipelines.
Product TeamValidates BIN data and supports risk/enrichment workflows.

Tags

BIN dataPagos APIBIN lookupenhanced BIN dataMCP serveruvClaude DesktopAPI key