A Model Context Protocol (MCP) server for the Have I Been Pwned (HIBP) API that allows you to query breach data using natural language.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hibp --env HIBP_API_KEY='<HIBP_API_KEY>' --env HIBP_SUBSCRIPTION_PLAN='<HIBP_SUBSCRIPTION_PLAN>' -- npx -y @darrenjrobinson/hibp-mcp~/.codex/config.toml
[mcp_servers.hibp]
command = "npx"
args = ["-y", "@darrenjrobinson/hibp-mcp"]
env = { HIBP_API_KEY = "<HIBP_API_KEY>", HIBP_SUBSCRIPTION_PLAN = "<HIBP_SUBSCRIPTION_PLAN>" }
# codex mcp add hibp --env HIBP_API_KEY='<HIBP_API_KEY>' --env HIBP_SUBSCRIPTION_PLAN='<HIBP_SUBSCRIPTION_PLAN>' -- npx -y @darrenjrobinson/hibp-mcp~/.cursor/mcp.json
{
"mcpServers": {
"hibp": {
"command": "npx",
"args": [
"-y",
"@darrenjrobinson/hibp-mcp"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"HIBP_SUBSCRIPTION_PLAN": "<HIBP_SUBSCRIPTION_PLAN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hibp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@darrenjrobinson/hibp-mcp"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"HIBP_SUBSCRIPTION_PLAN": "<HIBP_SUBSCRIPTION_PLAN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hibp": {
"command": "npx",
"args": [
"-y",
"@darrenjrobinson/hibp-mcp"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"HIBP_SUBSCRIPTION_PLAN": "<HIBP_SUBSCRIPTION_PLAN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hibp": {
"command": "npx",
"args": [
"-y",
"@darrenjrobinson/hibp-mcp"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"HIBP_SUBSCRIPTION_PLAN": "<HIBP_SUBSCRIPTION_PLAN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hibp": {
"command": "npx",
"args": [
"-y",
"@darrenjrobinson/hibp-mcp"
],
"env": {
"HIBP_API_KEY": "<HIBP_API_KEY>",
"HIBP_SUBSCRIPTION_PLAN": "<HIBP_SUBSCRIPTION_PLAN>"
}
}
}
}Environment variables
HIBP_API_KEYHIBP_SUBSCRIPTION_PLAN
Replace the placeholders with your own credentials and keep them out of version control.