Jambozx/onlinecybertools-mcp-server

MCP (Model Context Protocol) server that lets AI agents — Claude Code, Codex,
Cursor, Continue, etc. — use the
Online Cyber Tools catalogue as a set of
native MCP tools.
What it exposes
- One MCP tool per documented MCP-compatible /api/tools/{category}/{tool}
operation. POST tools use their JSON request-body schema; compatible
GET tools use OpenAPI query/path parameters. Schemas are taken straight
from the site's OpenAPI 3.1 spec at /api/openapi.json, so agents get
per-tool argument validation. When the spec declares them, a tool also
carries MCP annotations (title plus readOnlyHint /
destructiveHint / idempotentHint, sourced from x-mcp-annotations)
and an outputSchema (the inline 200 response object schema).
- A search meta-tool that performs the same keyword search humans use,
backed by GET /api/tools/search?q=....
- A describe_tool meta-tool that fetches the long page guidance, source
links, page URL, API endpoint, and SEO description from
GET /api/mcp/tool-docs/{tool_id}. It accepts either a menu ID such as
ping or an MCP tool name such as network_ping.
- A report_bug meta-tool that files a structured bug report against
POST /api/agent/bug-report (hard rate-limited).
Calls are proxied to the live HTTP API — no algorithm is re-implemented here.
That guarantees agents see whatever the deployed site does.
Generated tool descriptions are the operation's OpenAPI summary + description,
nothing else — no menu-ID prefix or describe_tool pointer (both read as
noise to a calling agent). The describe_tool meta-tool is still available
for agents that want the full page guidance on demand.
Tools
This server exposes **279 tools** across 15 categories:
Encoding/Decoding, Binary/Text Conversion, Cryptography & Hashing, Web Dev Utilities, Text Utilities, OSINT Tools, Networking Tools, Security Tools, SEO Tools, Linux Tools, Date & Time, Math & Calculators, Data Tools, File Tools, Reverse Engineering.
- **Full list (this repo):** TOOLS.md — every tool, grouped by category.
- **Live catalogue:**
- **Machine-readable spec:**
- **Pick a subset / build a config:**
This section and TOOLS.md are auto-generated from the live menu on
every release, so the count and list never drift.
Quick start
The package is published on npm as
onlinecybertools-mcp-server,
so any MCP client can launch it with npx -y onlinecybertools-mcp-server
— no clone, no global install. The config snippets below work as-is and
expose the **full tool catalogue** by default.
Prefer a guided setup? Generate a ready-made Claude Code plugin or Codex
config block from the website's interactive builder:
** **
The builder lets you pick a subset of tools and emits the matching
OCTOOLS_TOOLS filter for you (see Configuration).
Configuration
Configure via environment variables. All are optional.
| Variable | Default | Purpose |
|---------------------------------|-----------------------------------------|---------|
| OCTOOLS_BASE_URL | https://onlinecybertools.com | Site to proxy requests to. |
| OCTOOLS_TOOLS | _(unset → all tools)_ | Comma-separated menu IDs (base64_encode,sha256,hash) to restrict the exposed surface. **Leave unset to expose every tool** — the examples below omit it on purpose. |