← Guides

tools.json validation errors

tools.json is a standard way to describe tools for AI assistants. Schema errors or wrong paths can prevent discovery.

Common causes

  • Invalid JSON or schema.
  • Wrong path (e.g. not at /.well-known/tools.json or /tools.json).
  • Missing required fields (name, description, etc.).

Fixes

  • Validate tools.json against the schema.
  • Expose at a standard path and link from llms.txt.
  • Include name, description, and inputSchema for each tool.

Validate tools.json

Related guides