Pagos Data MCP Server
# 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](https://docs.pagos.ai/bin-data/getting-started-with-bin-data#generate-an-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:
``` bash
brew install uv
```
Clone the repository:
``` bash
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.
``` json
{
"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"
}
}
}
}
```
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.