Toolkit MCP Server
by cyanheadsio.github.cyanheads/toolkit-mcp-serverv2.3.2
Generate IDs, QR codes, and hashes, encode values, geolocate IPs, plus gated host diagnostics.
context tax
queued
security
queued
cold start
queued
freshness
Active2d ago
Install Toolkit MCP server
Install in Claude Code
claude mcp add toolkit -e TOOLKIT_GEO_API_KEY='<toolkit-geo-api-key>' -- npx -y @cyanheads/toolkit-mcp-serverInstall in Cursor
{
"mcpServers": {
"toolkit": {
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"TOOLKIT_GEO_API_KEY": "<toolkit-geo-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"toolkit": {
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"TOOLKIT_GEO_API_KEY": "<toolkit-geo-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"toolkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"TOOLKIT_GEO_API_KEY": "<toolkit-geo-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"toolkit": {
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"TOOLKIT_GEO_API_KEY": "<toolkit-geo-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| MCP_LOG_LEVEL | — | — | Sets the minimum log level for output (e.g., 'debug', 'info', 'warn'). |
| TOOLKIT_ENABLE_NET_DIAGNOSTICS | — | — | Register the gated toolkit_check_network tool. Off by default — leave off for hosted/shared deployments. |
| TOOLKIT_ENABLE_SYSTEM_INFO | — | — | Register the gated toolkit_check_system tool. Off by default — only meaningful on a local deployment. |
| TOOLKIT_ALLOW_PRIVATE_NETWORK | — | — | With network diagnostics enabled, permit private/reserved/loopback targets. The second explicit gate; off by default. |
| TOOLKIT_GEO_API_KEY | — | yes | API key for the geolocation endpoint, if it requires one. The default ip-api tier is keyless. |
| TOOLKIT_GEO_BASE_URL | — | — | Base URL for an ip-api-compatible geolocation endpoint. Default is the keyless ip-api endpoint, which is plaintext HTTP. |
| TOOLKIT_GEO_CACHE_TTL_SECONDS | — | — | Geolocation cache TTL in seconds. Geolocation is stable, so repeats are cached. |
| TOOLKIT_GEO_RATE_LIMIT_PER_MIN | — | — | Max geolocation requests per minute; excess requests are rejected with a retryable rate-limit error. Default 45 matches the ip-api free tier. |
| MCP_TRANSPORT_TYPE | — | — | Selects the HTTP transport. |
| MCP_HTTP_HOST | — | — | The hostname for the HTTP server. |
| MCP_HTTP_PORT | — | — | The port to run the HTTP server on. |
| MCP_HTTP_ENDPOINT_PATH | — | — | The endpoint path for the MCP server. |
| MCP_AUTH_MODE | — | — | Authentication mode to use: 'none', 'jwt', or 'oauth'. |
Remote endpoints
- streamable-http
https://toolkit.caseyjhand.com/mcp
Freshness
Active — last maintenance signal 2d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-10-07 · 2d ago · GitHub · v2.3.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v2.3.2
FAQ
›How do I install the Toolkit MCP server in Claude Code?
Run: claude mcp add toolkit -e TOOLKIT_GEO_API_KEY='<toolkit-geo-api-key>' -- npx -y @cyanheads/toolkit-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Toolkit require an API key?
Yes. It expects TOOLKIT_GEO_API_KEY, of which 1 is a secret.
›Can I use Toolkit as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Toolkit in the official MCP registry?
Yes, as io.github.cyanheads/toolkit-mcp-server.