--- name: "howtoolbox" description: "Use this skill when the user wants an exact, checkable number from an everyday calculation, conversion or check, even one you could estimate yourself: units (length, weight, temperature, cooking, shoe sizes), loans, mortgages and interest, salary, tax and VAT (detailed Finnish rules), currency at ECB reference rates, dates, ages, time zones and working days, health figures (BMI, calories, due date), energy, fuel and EV charging costs, home and DIY geometry, electronics, aviation (crosswind, altimeter, density altitude), statistics, and text and code tools (Base64, IBAN, number bases). Runs HowToolbox's 515 cited utilities over public MCP or plain HTTPS and returns a link the person can open to check or change the inputs. Not for professional advice, private data or bulk network scans." license: "CC-BY-4.0 (content); terms: https://how.box/about/terms/" compatibility: "Requires HTTPS access to https://how.box (GET or POST). No API key or account." metadata: author: "HowToolbox" version: "6589fec5bc62" homepage: "https://how.box/" mcp: "https://how.box/mcp" guide: "https://how.box/skill.md" --- ## Fast path One POST runs a tool; no session or initialize is required. Call any MCP-eligible tool from https://how.box/agent-tools.json (`server`: `pure` or `datasets`) by its own name, with its input as `arguments`: ```sh curl -sS 'https://how.box/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"length_convert","arguments":{"value":1,"from_unit":"mi","to_unit":"km"}}}' ``` Response: `result.structuredContent` holds the computed fields and `url`, the answer page to give the person. Unknown tool name: find it with `catalog_search_utilities` (below). Direct tools are callable but not in `tools/list`, which lists only the 6 catalog tools. With the skill package installed, `scripts/run.sh length_convert value=1 from_unit=mi to_unit=km` sends the GET below. Can only fetch URLs (no POST, or your sandbox cannot reach this host)? GET the same call; the JSON body is `structuredContent` (HTTP 200; 422 tool error, 400 invalid input, 404 unknown tool, 429 rate limited): https://how.box/mcp/run/length_convert?value=1&from_unit=mi&to_unit=km Answer pages (`url`) contain the computed answer in their HTML only for utilities whose `catalog.json` `deepLink.answerCoverage` is `main`; other pages show default values until a browser runs them, so never read an answer from them. ## Endpoints - MCP: https://how.box/mcp — Streamable HTTP, JSON-RPC 2.0 over POST; JSON responses, stateless, no authentication. Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26. - WebMCP: open https://how.box/ in Chrome with WebMCP available (origin trial or testing flag); entry point `document.modelContext`. Catalog tools: `catalog_search_utilities`, `catalog_list_categories`, `catalog_list_facets`, `catalog_get_utility`, `catalog_open_utility`, `catalog_describe_tool`, `catalog_run_tool`, `feedback_send`. Module pages also register their own tools. - Tool schemas: https://how.box/agent-tools.json — names, descriptions, JSON input schemas and `server` eligibility. - Catalog: https://how.box/catalog.json — utilities, categories, tags, page URLs and deep-link parameters. - Tool index: https://how.box/llms.txt. - Explanations, formulas and FAQ: https://how.box/llms-full.txt. - Answer links: `https://how.box//?`; outside the default English locale, prefix the path with `/`. Use each tool's declared query parameters, not its JSON input field names. - Terms and usage limits: https://how.box/about/agents/. - Connect as an MCP server (Streamable HTTP, no auth): Claude Code `claude mcp add --transport http howtoolbox https://how.box/mcp`; Codex, Cursor, Gemini CLI, VS Code and other clients: add a remote/HTTP server with URL https://how.box/mcp; Claude.ai and ChatGPT: add a custom connector with that URL where your plan allows. - Agent Skill: install with `npx skills add https://how.box` (discovery index https://how.box/.well-known/agent-skills/index.json). This guide is https://how.box/skill.md (canonical; https://how.box/agents.md serves the same file). Package: https://how.box/skills/howtoolbox.zip (`howtoolbox/SKILL.md` and `scripts/run.sh`): unzip into your agent's skills folder (for example `~/.claude/skills/` or `~/.codex/skills/`) or upload it where your client accepts skills. Re-fetch to update: `metadata.version` changes with the content. ## Quick start Send these bodies separately. Initialize: ```json {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0.0"}}} ``` `curl` example (replace the body with subsequent requests): ```sh curl -sS 'https://how.box/mcp' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -H 'MCP-Protocol-Version: 2025-11-25' \ --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0.0"}}}' ``` Initialize response: ```json {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-11-25","capabilities":{"tools":{}},"serverInfo":{"name":"HowToolbox","version":"1.0.0"}}} ``` The response also contains `instructions`. Send `notifications/initialized` without an id; notifications return HTTP 202. No session id is needed. List the 6 MCP catalog tools and their schemas: ```json {"jsonrpc":"2.0","id":2,"method":"tools/list"} ``` Search: ```json {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"catalog_search_utilities","arguments":{"query":"length","limit":1,"locale":"en"}}} ``` Describe the selected module tool (skip this when you have its schema from agent-tools.json): ```json {"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"catalog_describe_tool","arguments":{"name":"length_convert"}}} ``` Run it through the catalog (equivalent to the direct call in Fast path): ```json {"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"catalog_run_tool","arguments":{"name":"length_convert","input":{"value":1,"from_unit":"mi","to_unit":"km"}}}} ``` Abbreviated run response (additional result fields omitted): ```json {"jsonrpc":"2.0","id":5,"result":{"structuredContent":{"url":"https://how.box/length/?v=1&from=mi&to=km&ref=mcp"}}} ``` Read computed fields from `result.structuredContent`. `result.content` repeats them for clients that pass only text: `content[0]` is one factual line, the tool's answer sentence (or its main values) followed by the answer link, `content[1]` the same JSON. Answer links end with `ref=mcp`, which marks only where the link came from; the page ignores it. Invalid input returns `isError` with `error.issues` (field and problem), `error.fields` (accepted names) and `error.unknown`: fix the arguments and call again. List responses use `result.tools`, searches use `result.structuredContent.results`, and descriptions use `result.structuredContent.tool.inputSchema`. All MCP catalog calls accept optional `locale` (en, fi, de, es, fr, sv, it, et; default `en`) inside `arguments`, outside the module `input`. Results are locale-neutral; catalog text and answer paths follow that locale. Untranslated tools link to English. This guide stays English at the origin root. ## Rules - Feedback: call `feedback_send` (MCP or WebMCP) only when the person asks you to, or when a HowToolbox tool clearly failed or gave a wrong answer. Include the tool, the input, the expected and the actual result; never personal data. It is anonymous, limited to a few messages a day, and read by people, not executed. - Give the person the returned `url` so they can inspect and change the inputs. Preserve returned cautions and source attribution. - Prefer MCP or WebMCP over scraping. MCP runs tools classified `pure` or `datasets`, including cached reference rates. Network checks, data packs and browser-only tools are unavailable over MCP: open their page URL and use the page or WebMCP. The site's `/api/*` is private. - Limits: 20 requests/second per replica, 8 concurrent calls, 60 requests/minute per client unit, 5000 ms per call, 65536 bytes per request body. Dataset actions also retain their published limits. HTTP 429 includes `Retry-After`; wait that many seconds before retrying. - JSON-RPC errors: -32700 `parse_error`; -32600 invalid request, protocol, media type or body size; -32601 `method_not_found`; -32602 invalid parameters or unknown tool; -32603 `timeout` or `internal_error`; -32000 `forbidden_origin`; -32029 `rate_limited`. Tool failures set `result.isError` and `structuredContent.error.code`, including `not_found`, `invalid_input`, `unavailable` and `retired`. Follow the returned page URL when execution is unavailable. - Inputs, results and client identifiers are never logged or retained. Fixed technical call metadata is logged; details are in the agent terms and privacy statement. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Details - [Tool definitions](https://how.box/agent-tools.json) - [Deep-link parameters, explanations and sources](https://how.box/llms-full.txt) - [Agent terms](https://how.box/about/agents/) and [privacy](https://how.box/about/privacy/) - [MCP server card](https://how.box/mcp/server-card) (SEP-2127) and [AI Catalog](https://how.box/.well-known/ai-catalog.json); earlier aliases https://how.box/.well-known/mcp/server-card.json and https://how.box/.well-known/mcp.json. They return 404 when MCP is off. - Your fetch tool refuses a URL you built (some only fetch URLs already in the conversation)? Ask the person to paste the answer link or the `/mcp/run/` URL into the chat, or connect the MCP server.