---
title: FAQ
description: Frequently asked questions about AI Workflow MCP.
type: troubleshooting
summary: Practical answers for agent users and integrators.
related:
  - /en/docs
  - /en/docs/client-setup
  - /en/docs/api-keys
  - /en/docs/release-notes
---

# FAQ



## Should tool inputs be English? [#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? [#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? [#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? [#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? [#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? [#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? [#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? [#what-does-fresh_onlytrue-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? [#is-statusaiworkflowmcpcom-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? [#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.


---

For a semantic overview of all documentation, see [/en/sitemap.md](/en/sitemap.md)

For an index of all available documentation, see [/en/llms.txt](/en/llms.txt)