WebRef (paid) MCP server
dev.workers.johnaio281.webref · Updated
Web standards and time reference for agents: HTTP codes, retries, deadlines. Paid via x402.
At a glance
WebRef (paid) is an MCP server in the Docs & Knowledge category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 14 tools, including http_status, status_for_situation and retry_advice. It scores B (65/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install WebRef (paid) in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install WebRef (paid) in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add --transport http webref https://webref.johnaio281.workers.dev/mcpVerify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. http_status, status_for_situation, retry_advice). It discovers them automatically.
How to install WebRef (paid) in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "webref": { "command": "npx", "args": [ "-y", "mcp-remote", "https://webref.johnaio281.workers.dev/mcp" ] } } }Why the wrapper?
This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install WebRef (paid) in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "webref": { "url": "https://webref.johnaio281.workers.dev/mcp" } } }Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install WebRef (paid) in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.webref] command = "npx" args = ["-y", "mcp-remote", "https://webref.johnaio281.workers.dev/mcp"]Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install WebRef (paid) in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "webref": { "serverUrl": "https://webref.johnaio281.workers.dev/mcp" } } }Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install WebRef (paid) in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "webref": { "type": "streamableHttp", "url": "https://webref.johnaio281.workers.dev/mcp" } } }
How to install WebRef (paid) in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "webref": { "type": "http", "url": "https://webref.johnaio281.workers.dev/mcp" } } }Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What tools does WebRef (paid) expose? (14)
Read from the live server. Click any tool for its input schema.
- http_statusLook up an HTTP status code: what it means, what the client must do, whether it is retryable, whether it is safe to replay, the defining RFC and the common causes. ($0.003 per call)
- status_for_situationFind the HTTP status code that matches a described situation, when the code is not known in advance — for example 'the caller is being rate limited' or 'upstream returned garbage'. ($0.005 per call)
- retry_adviceDecide how a client should react to a status code: retry with backoff, check the outcome before retrying, or do not retry. Includes a suggested backoff schedule. ($0.005 per call)
- mime_typeLook up a MIME type by full type or by file extension: the top-level type, what it is for, and the usual file extension. ($0.003 per call)
- list_mime_typesList or search MIME types by top-level type or by keyword, for example image types or anything to do with calendars. ($0.003 per call)
- content_type_adviceCheck whether a Content-Type header matches what an endpoint kind expects, and say what to send instead when it does not. ($0.003 per call)
- http_methodDescribe an HTTP method: whether it is safe, whether it is idempotent, whether it carries a body, and what it is for. ($0.003 per call)
- time_untilHow much time is between two instants: the direction, the total in every unit, and a day/hour/minute/second breakdown. Use it to compute a retry delay, a rate-limit reset, or whether a deadline has passed. ($0.003 per call)
- describe_instantDescribe an instant: its date, weekday and time in UTC and in Tehran local time (UTC+03:30), plus the Unix timestamp. Use it when a response carries a timestamp and the local date matters. ($0.003 per call)
- weekday_ofWhich day of the week a date falls on, and whether it is a business day. Use it before scheduling work or setting a deadline that lands on a weekend. ($0.003 per call)
- business_days_betweenCount the business days between two dates, excluding weekends. Use it to turn a calendar deadline into a working-day deadline. Public holidays are not excluded, so the count is an upper bound. ($0.005 per call)
- add_durationAdd a duration to an instant and get the result, in UTC and in Tehran local time. Use it for a TTL, a lock expiry, or a token lifetime. ($0.003 per call)
- convert_durationConvert a duration between units and get it in plain language. Use it to express a timeout in the unit the caller asked for, or to check whether a limit is seconds, minutes or milliseconds. ($0.003 per call)
- unix_timeConvert between a date and a Unix timestamp, in either direction. Use it when a payload carries one and the other is needed. ($0.003 per call)
What the code can do
This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Third-party hosted service — Your requests and any data in them are sent to webref.johnaio281.workers.dev.
- No local execution — Nothing is installed or run on your machine.
Client compatibility
Health score
B · 65Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%not measurable
No commit history available.
- Adoption20%not measurable
No usage data available.
- Transparency20%50%
2/4: ✓ public source repo, ✗ declared license, ✗ documentation, ✓ discoverable tool list.
- Provenance15%75%
Links to its own repository; package linkage unverified.
- Packaging15%75%
Remote endpoint; authentication requirements not declared.
Alternatives to WebRef (paid)
- SA Business CalendarB · 76South African business days, public holidays and SARS EMP201/VAT201 deadlines.
- PlugRail Japanese CalendarB · 73Japanese holiday and business-day calculations using official Japan Cabinet Office data.
- Business Day CalendarsD · 33NYSE, Federal Reserve, TARGET2 and UK business days, holidays and T+N settlement dates.
Maintain WebRef (paid)? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/dev-workers-johnaio281-webref-webref)Catalog data refreshed . Something wrong? Report it.