Access Pagos BIN Data
Look up card BIN (Bank Identification Number) data via Pagos, with optional enhanced attributes for richer payment insights.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Integrate with the Pagos API to retrieve comprehensive Bank Identification Number (BIN) data for credit cards. Enhance financial analysis with basic or detailed BIN information.
Outcomes
What it gets done
Retrieve BIN data using the provided BIN number.
Configure enhanced BIN data retrieval for detailed analytics.
Access basic BIN data with optional extended functionality.
Securely manage API keys for Pagos API access.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-pagos | bash Capabilities
Tools your agent gets
Retrieve BIN data for the specified BIN number with basic or enhanced attributes
Overview
Pagos MCP Server
Pagos Data MCP Server gives an AI assistant BIN data lookup for payment cards via the Pagos API, with an optional enhanced-attributes mode for richer insights. Use it when an AI assistant needs card BIN issuer/network data for payments or fraud analysis. Requires a Pagos API key; check contract costs before enabling enhanced BIN data.
What it does
Pagos Data MCP Server gives an AI assistant access to BIN (Bank Identification Number) data through the Pagos API, letting it look up card issuer and network information for a given BIN number.
When to use - and when NOT to
Use it when you want to identify details about a payment card's BIN - such as during fraud analysis, payment routing decisions, or reconciliation work. Enable ENHANCED_BIN_DATA=true for richer BIN response attributes (basic data is returned by default when unset or false); check your Pagos contract for any additional costs before enabling enhanced data. Do not use it without a Pagos API key - it's required to authenticate calls to the BIN data service.
Capabilities
- Get BIN data for a given BIN number, with basic or enhanced response attributes depending on the
ENHANCED_BIN_DATAsetting.
How to install
Install uv and clone the repository:
brew install uv
git clone https://github.com/pagos-ai/pagos-mcp.git
Generate a Pagos API key per the Pagos BIN Data documentation, then configure Claude Desktop:
{
"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"
}
}
}
}
Who it's for
Payments and fraud teams who want an AI assistant to look up card BIN details - issuer, network, and enhanced attributes - conversationally instead of querying the Pagos API directly.
Source README
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"
}
}
}
}
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.