The Model Context Protocol (MCP) is an open protocol designed by Anthropic to standardize how applications provide information and context to large language models (LLMs). It defines a consistent, structured way for LLMs to securely query external data through lightweight local servers. The Pagos MCP Server allows AI agents and applications to query the payments intelligence available through Pagos. Once connected, you can use AI agents to query BIN data from our BIN Database for a given BIN number.

​
Configuration

To configure the Pagos MCP Server to query BIN data:
1

Generate an API Key

Follow the instructions in our BIN Data API Overview guide to generate an API key for our BIN Database.
2

Clone the Repository Locally and Install uv

On MacOs, install uv with Homebrew:
brew install uv
Next, clone the repository:
git clone https://github.com/pagos-ai/pagos-mcp.git
3

Add the MCP Server to Desktop Claude

On MacOs, ~/Library/Application\ Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "bin-data": {
      "command": "python",
      "args": [
        "/path/to/pagos-mcp-server/pagos-mcp-server.py"
      ],
      "env": {
        "PAGOS_API_KEY": "your-pagos-api-key"
      }
    }
  }
}