FAQ
Frequently asked questions about AI Workflow MCP.
Should tool inputs be English?
Yes. AI Workflow MCP is English-first. Agents should translate non-English user requests into concise English before calling tools.
The server includes query expansion for common Chinese terms, but that is recovery logic, not the primary contract.
What happens when a required argument is missing?
The server returns a JSON-RPC -32602 invalid params error before tool execution. This prevents misleading fallbacks such as looking up a model literally named undefined.
What happens when a model, tool, or skill is not found?
Tool-level recoverable failures return structuredContent.error with a stable code, message, recoverable, and suggestions array. Agents should pick from suggestions or call the relevant list/search tool.
Do public calls require an API key?
Basic public REST and MCP calls work without a key. Authenticated keys add account-level usage history and quota routing.
Where do users create API keys?
Users sign in at https://aiworkflowmcp.com/en/sign-in/ and manage keys at https://aiworkflowmcp.com/en/account/api-keys/.
Keys are shown once. Store the secret as AIWORKFLOWMCP_API_KEY and send it as Authorization: Bearer ${AIWORKFLOWMCP_API_KEY}.
Where are API keys stored?
D1 stores only hashed keys plus metadata. The full secret is shown once at creation and is not stored.
What data is live?
Production reads Cloudflare D1 and R2. D1 stores structured rows and R2 stores evidence packages and full Markdown.
What does fresh_only=true do?
It asks search endpoints and tools to reject stale facts. Use it for workflows where current source-backed facts matter more than recall.
Is status.aiworkflowmcp.com the docs app?
No. Production docs live inside the main product shell at aiworkflowmcp.com/en/docs. docs.aiworkflowmcp.com is kept only as a compatibility redirect. status.aiworkflowmcp.com is a lightweight Worker status surface.
Which docs framework is this site using?
The production docs app uses Geistdocs/Fumadocs on Next.js, deployed through OpenNext Cloudflare. It is not a Mintlify-hosted site.