🤖MCP API & Interface

Let MCP-compatible AI agents such as Claude and Cursor search TWC and call stateless trade utilities directly. The interface is free, needs no authentication, and stores no request data.

L1 · Static discovery layer

  • /llms.txt: a panoramic index of all three sections, written for large models (Markdown).
  • /mcp/catalog.json: a structured list of online tools, trade websites, and featured software (JSON).

L2 · Protocol execution layer

Endpoint POST https://tools.waoww.com/mcp, JSON-RPC 2.0, Streamable HTTP transport (JSON responses only, no SSE push). Supports initialize, ping, tools/list, and tools/call.

Client config example

{
  "mcpServers": {
    "twc": { "url": "https://tools.waoww.com/mcp" }
  }
}

curl example

curl -s https://tools.waoww.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_twc_catalog","arguments":{"query":"HS code"}}}'

Available tools

NamePurpose
search_twc_catalogSearch across online tools, trade websites, and featured software by keyword, optionally limited to one section.
generate_folder_scriptIndented directory tree or path list → BAT / PowerShell / Bash batch folder-creation script; handles Windows illegal characters and reserved names automatically.
build_pi_ci_linkGenerate a prefilled PI/CI invoice tool link and compute totals; invoice data lives in the URL #fragment and never passes through any server.
generate_email_signatureGenerate an HTML email signature with table layout and inline styles (compatible with Outlook / Gmail / Foxmail), plus a plain-text version.
generate_secure_passwordCryptographically secure random numbers with rejection sampling generate strong passwords, with an entropy estimate; nothing is logged or stored.
text_diff_and_statsLine-level diff of two texts (for checking contract / quotation changes) plus character, word, and line counts.

AI agents can also drive the browser directly

You don't need MCP to use this site's tools: let an AI assistant that can operate a browser open a tool page and follow the on-page steps. No API key, no setup.

  • 17 of the 22 live tools are AI-Ready (except image watermark, image cropper, image collage, multi-device responsive preview, and the 3D model viewer). List cards and tool-page headers carry the "AI-Ready" tag; clicking the tag on a tool page jumps to that page's "How to Let AI Use It" section, which has step-by-step instructions (button ids match the workbench) and a sample prompt — for example Random Password Generator.
  • 5 of these tools also have MCP tools (the strong password, folder script, PI/CI prefilled link, email signature, and text diff in the table above), served by the L2 endpoint above; the other 12 are browser-only for now.
  • Discovery layer: /mcp/catalog.json (schema 1.1, each record includes aiReady, input, output, and limits fields), /llms.txt, and /llms-full.txt all work as AI-readable lists.

Data & privacy

All MCP tools are stateless pure computation; the Worker writes no logs and stores nothing. Request bodies are limited to 1 MB. Do not submit sensitive personal information through the interface.