Toolkit Mcp Server
by cyanheadscommunityv2.0.1
18
9
An MCP server that provides utilities for generating hashes, random IDs, QR codes, and encoded/decoded values, plus IP geolocation. It also includes optional gated tools for network diagnostics and host system information.
From the registry: Generate IDs, QR codes, and hashes, encode values, geolocate IPs, plus gated host diagnostics.
Install & configure
Prerequisites
- requiredInstall Node.js or BunInstall Node.js v24+ or Bun v1.3.2+ to run the server. The most portable path in the README is via npx, which uses Node.js.https://bun.sh/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `toolkit-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js or Bun** — Install Node.js v24+ or Bun v1.3.2+ to run the server. The most portable path in the README is via npx, which uses Node.js. (https://bun.sh/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/toolkit-mcp-server@latest"]
- optional environment variables:
- `MCP_TRANSPORT_TYPE`: Transport mode for the server. Use "stdio" for MCP client config. (example: `stdio`)
- `MCP_LOG_LEVEL`: Log level (RFC 5424). (example: `info`)
- `TOOLKIT_ENABLE_NET_DIAGNOSTICS`: Enable the gated toolkit_check_network tool. (example: `true`)
- `TOOLKIT_ENABLE_SYSTEM_INFO`: Enable the gated toolkit_check_system tool. (example: `true`)
- `TOOLKIT_ALLOW_PRIVATE_NETWORK`: When network diagnostics are enabled, permit private/reserved/loopback targets. Cloud metadata endpoint remains blocked by default unless explicitly allowed by server behavior. (example: `true`)
- `TOOLKIT_GEO_PROVIDER`: IP geolocation provider ID. Default is the keyless ip-api provider. (example: `<your-provider-id>`)
- `TOOLKIT_GEO_API_KEY`: API key for the geolocation provider, if the selected provider requires one. (example: `<your-api-key>`)
- `TOOLKIT_GEO_BASE_URL`: Base URL for the geolocation provider. (example: `<your-geolocation-base-url>`)
- `TOOLKIT_GEO_CACHE_TTL_SECONDS`: In-memory geolocation cache TTL in seconds. (example: `<your-cache-ttl-seconds>`)
- `TOOLKIT_GEO_RATE_LIMIT_PER_MIN`: Maximum geolocation requests per minute. (example: `<your-rate-limit-per-minute>`)
- `MCP_AUTH_MODE`: Authentication mode: none, jwt, or oauth. (example: `<none-or-auth-mode>`)
- `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `true`)
Note: The README also supports Streamable HTTP transport, but the simplest portable MCP client configuration shown is stdio via npx. For HTTP mode, the server is started separately with MCP_TRANSPORT_TYPE=http and MCP_HTTP_PORT set, and listens at /mcp.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README also supports Streamable HTTP transport, but the simplest portable MCP client configuration shown is stdio via npx. For HTTP mode, the server is started separately with MCP_TRANSPORT_TYPE=http and MCP_HTTP_PORT set, and listens at /mcp.
Tools (7)
toolkit_hash_value
Generate a cryptographic digest or compare a value against an expected digest.
toolkit_generate_id
Generate cryptographically random UUIDv4, UUIDv7, or ULID identifiers, singly or in batches.
toolkit_generate_qr
Encode text or a URL into a QR code as SVG, base64 PNG, or terminal-renderable output.
toolkit_encode_value
Encode or decode values using base64, base64url, hex, or URL percent-encoding.
toolkit_geolocate_ip
Resolve a public IP or hostname to geographic and network metadata.
toolkit_check_network
Run gated read-only network diagnostics from the server host, such as ping, traceroute, TCP connectivity, or public IP detection.
toolkit_check_system
Run gated read-only system checks on the server host, such as OS, CPU, memory, load, or network interfaces.
Environment variables
TOOLKIT_ENABLE_NET_DIAGNOSTICSRegisters the gated network diagnostics tool.TOOLKIT_ENABLE_SYSTEM_INFORegisters the gated system information tool.TOOLKIT_ALLOW_PRIVATE_NETWORKAllows private/reserved/loopback targets when network diagnostics are enabled.Prerequisites
- • Node.js v24+
Packages
@cyanheads/toolkit-mcp-server
npmv2.0.1transport: stdio
@cyanheads/toolkit-mcp-server
npmv2.0.1transport: streamable-http
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Jun 28, 2026
- Last commit
- Jun 28, 2026
- Registry name
- io.github.cyanheads/toolkit-mcp-server