SkanQRCode — Claude Code MCP server for URL checks
Checks URLs and IP addresses before an agent opens or fetches a link. Useful for links found in email, chat, QR codes, or other untrusted content.
claude mcp add mcp-server -e SKANQRCODE_API_KEY=<SKANQRCODE_API_KEY> -- npx -y @skanqrcode/mcp-serverWhat SkanQRCode does
SkanQRCode sends a URL or IP address to its API and returns a verdict with an action: block the request, warn the user, or allow it. An agent can check a link before fetching it. Each check_url call uses one unit of the monthly quota; get_usage reports usage and remaining quota without consuming a unit.
The server runs locally over stdio. It needs Node.js 20 or later and an API key set as SKANQRCODE_API_KEY; without the key, checks cannot run. The server is read-only, so allow and block lists are managed in the dashboard. An sk_test_ key is for testing, while production use requires an sk_live_ key from a paid plan.
What it helps with
- check a URL before following it
- evaluate an IP address for safety
- ask the user before opening a link marked
warn - check remaining monthly quota
Example prompts for the agent
- Check this URL with SkanQRCode before opening it.
- Assess this IP with SkanQRCode and follow the returned action.
- Show me the remaining SkanQRCode quota for this month.
How to install SkanQRCode
Platform CLI
claude mcp add mcp-server -e SKANQRCODE_API_KEY=<SKANQRCODE_API_KEY> -- npx -y @skanqrcode/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add server --env SKANQRCODE_API_KEY=<SKANQRCODE_API_KEY> -- npx -y @skanqrcode/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"server": {
"command": "npx",
"args": [
"-y",
"@skanqrcode/mcp-server"
],
"env": {
"SKANQRCODE_API_KEY": "<SKANQRCODE_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@skanqrcode/mcp-server"
],
"env": {
"SKANQRCODE_API_KEY": "<SKANQRCODE_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SKANQRCODE_API_KEY=<SKANQRCODE_API_KEY> server npx -y @skanqrcode/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SkanQRCode
How do I install SkanQRCode in Claude Code?
Run claude mcp add mcp-server -e SKANQRCODE_API_KEY=<SKANQRCODE_API_KEY> -- npx -y @skanqrcode/mcp-server. Node.js 20 or later is required.
What does SkanQRCode do?
It checks URLs and IP addresses through the SkanQRCode API, then returns an action: block, warn, or allow. The agent can use that result before fetching or opening a link.
Does SkanQRCode need an API key?
Yes. Set it in SKANQRCODE_API_KEY. An sk_test_ key is for testing; production requires an sk_live_ key from a paid plan.
