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

See our API Authentication guide for full instructions on generating API keys and authenticating with the Pagos APIs.
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"
      }
    }
  }
}