MCP Server
MCP
io.github.cyanheads/toolkit-mcp-server
By Generate IDs, QR codes, and hashes, encode values, geolocate IPs, plus gated host diagnostics.
Install
npx -y @cyanheads/[email protected]Configuration Example
{
"remotes": [
{
"type": "streamable-http",
"url": "https://toolkit.caseyjhand.com/mcp"
}
],
"packages": [
{
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"identifier": "@cyanheads/toolkit-mcp-server",
"version": "2.2.2",
"runtimeHint": "bun",
"transport": {
"type": "stdio"
},
"packageArguments": [
{
"value": "run",
"type": "positional"
},
{
"value": "start:stdio",
"type": "positional"
}
],
"environmentVariables": [
{
"description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
"format": "string",
"default": "info",
"name": "MCP_LOG_LEVEL"
},
{
"description": "Register the gated toolkit_check_network tool. Off by default — leave off for hosted/shared deployments.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ENABLE_NET_DIAGNOSTICS"
},
{
"description": "Register the gated toolkit_check_system tool. Off by default — only meaningful on a local deployment.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ENABLE_SYSTEM_INFO"
},
{
"description": "With network diagnostics enabled, permit private/reserved/loopback targets. The second explicit gate; off by default.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ALLOW_PRIVATE_NETWORK"
},
{
"description": "API key for the geolocation endpoint, if it requires one. The default ip-api tier is keyless.",
"format": "string",
"isSecret": true,
"name": "TOOLKIT_GEO_API_KEY"
},
{
"description": "Base URL for an ip-api-compatible geolocation endpoint. Default is the keyless ip-api endpoint, which is plaintext HTTP.",
"format": "string",
"default": "http://ip-api.com",
"name": "TOOLKIT_GEO_BASE_URL"
},
{
"description": "Geolocation cache TTL in seconds. Geolocation is stable, so repeats are cached.",
"format": "string",
"default": "3600",
"name": "TOOLKIT_GEO_CACHE_TTL_SECONDS"
},
{
"description": "Max geolocation requests per minute; excess requests are rejected with a retryable rate-limit error. Default 45 matches the ip-api free tier.",
"format": "string",
"default": "45",
"name": "TOOLKIT_GEO_RATE_LIMIT_PER_MIN"
}
]
},
{
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"identifier": "@cyanheads/toolkit-mcp-server",
"version": "2.2.2",
"runtimeHint": "bun",
"transport": {
"type": "streamable-http",
"url": "http://localhost:3010/mcp"
},
"packageArguments": [
{
"value": "run",
"type": "positional"
},
{
"value": "start:http",
"type": "positional"
}
],
"environmentVariables": [
{
"description": "The hostname for the HTTP server.",
"format": "string",
"default": "127.0.0.1",
"name": "MCP_HTTP_HOST"
},
{
"description": "The port to run the HTTP server on.",
"format": "string",
"default": "3010",
"name": "MCP_HTTP_PORT"
},
{
"description": "The endpoint path for the MCP server.",
"format": "string",
"default": "/mcp",
"name": "MCP_HTTP_ENDPOINT_PATH"
},
{
"description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
"format": "string",
"default": "none",
"name": "MCP_AUTH_MODE"
},
{
"description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
"format": "string",
"default": "info",
"name": "MCP_LOG_LEVEL"
},
{
"description": "Register the gated toolkit_check_network tool. Off by default — leave off for hosted/shared deployments.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ENABLE_NET_DIAGNOSTICS"
},
{
"description": "Register the gated toolkit_check_system tool. Off by default — only meaningful on a local deployment.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ENABLE_SYSTEM_INFO"
},
{
"description": "With network diagnostics enabled, permit private/reserved/loopback targets. The second explicit gate; off by default.",
"format": "string",
"default": "false",
"name": "TOOLKIT_ALLOW_PRIVATE_NETWORK"
},
{
"description": "API key for the geolocation endpoint, if it requires one. The default ip-api tier is keyless.",
"format": "string",
"isSecret": true,
"name": "TOOLKIT_GEO_API_KEY"
},
{
"description": "Base URL for an ip-api-compatible geolocation endpoint. Default is the keyless ip-api endpoint, which is plaintext HTTP.",
"format": "string",
"default": "http://ip-api.com",
"name": "TOOLKIT_GEO_BASE_URL"
},
{
"description": "Geolocation cache TTL in seconds. Geolocation is stable, so repeats are cached.",
"format": "string",
"default": "3600",
"name": "TOOLKIT_GEO_CACHE_TTL_SECONDS"
},
{
"description": "Max geolocation requests per minute; excess requests are rejected with a retryable rate-limit error. Default 45 matches the ip-api free tier.",
"format": "string",
"default": "45",
"name": "TOOLKIT_GEO_RATE_LIMIT_PER_MIN"
}
]
}
]
}
mcp
model-context-protocol
streamable-http
npm
Comments
Sign in to leave a comment