Pagos Data MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pagos Data MCP Serverget BIN data for 411111"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Pagos Data MCP Server
Capabilities
Get BIN data for a given BIN number.
Related MCP server: Bin Lookup Checker API MCP Server
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 uvClone the repository:
git clone https://github.com/pagos-ai/pagos-mcp.gitAdd 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"
}
}
}
}Available Tools
1 toolget_bin_data_toolA
Get BIN data for a given BIN number.
Args: bin (str): The BIN number to get data for. Returns: str: A formatted string containing the BIN data (enhanced or basic based on ENHANCED_BIN_DATA config).
| Name | Required | Description | Default |
|---|---|---|---|
| bin | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Description discloses return format and config dependency (basic vs enhanced). However, no annotations are present, and the description does not cover error behavior, side effects, or permissions, which are important for a data retrieval tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Extremely concise with two clear sections (Args, Returns). No wasteful words, highly structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter, no-output-schema tool, the description covers basic functionality and return type. Lacks error handling details, but overall sufficient for its complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema provides only parameter name and type (0% coverage). Description adds meaning by explaining 'bin' is the BIN number to query, which compensates for the lack of schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clear verb 'Get' and resource 'BIN data' stated explicitly. Distinguishes itself from potential siblings by specifying it operates on a BIN number.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool or when alternatives might be better. Since no siblings exist, it still lacks contextual usage hints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
get_bin_data_tool
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool has a single, clear purpose of retrieving BIN data, so an agent cannot misselect between multiple options.
The tool name 'get_bin_data_tool' follows a consistent verb_noun pattern with a clear action ('get') and object ('bin_data'), and the naming is straightforward. Since there is only one tool, consistency is inherently perfect.
A single tool is too few for a server with the name 'Pagos Data MCP Server', which suggests a broader data-related domain. This minimal toolset limits functionality and may not cover expected operations like searching, listing, or updating data, making it feel incomplete and under-scoped.
The tool surface is severely incomplete for a data server. It only provides a 'get' operation for BIN data, with no support for other CRUD operations (create, update, delete), search, or listing capabilities. This creates significant gaps that will likely cause agent failures when trying to perform common data tasks.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
IBAN validation, extraction, format specs and BIC/SWIFT lookup tools for AI assistants.
Cross-border payment & banking intelligence for AI agents: SWIFT/BIC, IBAN, sanctions, FX, tracking.
Global B2B intelligence for AI agents: 35M+ companies, 1.6M sanctions, KYB pack. 78 tools.
Web search, scraping, Google Trends and data lookups. Paid per call in USDC on Base via x402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.11MIT
- AlicenseDqualityDmaintenanceEnables bank identification number (BIN) lookups via the Bin Lookup Checker API. It allows users to retrieve information about card issuers, card types, and brands using a specific BIN.1MIT

Pagos Data MCP Serverofficial
FlicenseAqualityFmaintenanceEnables users to retrieve BIN data for a given BIN number, with optional enhanced attributes for richer insights.11-
BlockRun MCPofficial
AlicenseAqualityAmaintenanceProvides Claude with real-time access to markets, research, X/Twitter, and crypto data via a unified pay-per-call system with no API keys.191,419395MIT