Pagos MCP Server

What does “Pagos” MCP Server do?

The Pagos MCP (Model Context Protocol) Server acts as a bridge between AI assistants and the Pagos API, empowering AI-driven workflows with access to real-time BIN (Bank Identification Number) data. By serving as an intermediary, it allows AI tools and agents to query Pagos for detailed information about payment cards using BIN numbers. This integration enables tasks such as verifying card types, issuers, and other relevant BIN-related information, enhancing development workflows that require payment data intelligence. The Pagos MCP Server is especially useful for developers and businesses needing accurate and timely card data for fraud prevention, compliance, or analytics within their AI ecosystems.

List of Prompts

No prompt templates are explicitly documented or mentioned in the repository.

List of Resources

No explicit MCP resource primitives are documented or mentioned in the repository.

List of Tools

• get_bin_data: Provides BIN data for a given BIN number by querying the Pagos API. This tool enables clients to fetch card-related metadata, such as issuer, card type, and other relevant attributes, using the provided BIN.

Use Cases of this MCP Server

• Payment Card Verification: Instantly retrieve and validate details about a credit or debit card by its BIN, helping businesses and developers ensure card authenticity and reduce fraud.
• Fraud Detection and Prevention: Use BIN data to spot suspicious card activity or mismatches between card types and transaction patterns, improving security workflows.
• Compliance and Regulatory Checks: Satisfy Know Your Customer (KYC) and anti-money laundering requirements by validating card issuers and regions through BIN lookups.
• Analytics and Reporting: Enhance analytics dashboards with insights into customer payment methods and trends based on BIN data, supporting better business decisions.

How to set it up

Windsurf

No setup instructions for Windsurf are provided in the repository.

Claude

1. Install prerequisites:
   Install uv using Homebrew:

   brew install uv
   

2. Clone the repository:

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

3. Edit the Claude desktop configuration:
   Update ~/Library/Application Support/Claude/claude_desktop_config.json with your specific values.
4. Add the Pagos MCP Server configuration:

   {
       "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>"
               }
           }
       }
   }
   

5. Save and restart Claude:
   Restart Claude for the changes to take effect.

Securing API Keys:
Store PAGOS_API_KEY in the environment variable section of the configuration as shown above.

Cursor

No setup instructions for Cursor are provided in the repository.

Cline

No setup instructions for Cline are provided in the repository.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "pagos": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “pagos” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

The Pagos MCP Server is focused and straightforward, offering a single, clear tool for BIN data lookups. While it is well-suited for payment-related workflows, its documentation is minimal, lacking detailed resources, prompt templates, or broader integration guides beyond Claude Desktop. Given the limited scope but precise utility, we’d rate this MCP a 4/10 for general-purpose MCP needs, but higher for payment-specific tasks.

MCP Score