Incompatible JSON Schema ($dynamicRef) in Firecrawl MCP server tools

[liamiam99]

Hello Firecrawl team,

I'm encountering an issue when using the Firecrawl MCP server with my MCP client/VS Code. The following error appears for all Firecrawl tools:

The schema uses meta-schema features ($dynamicRef) that are not yet supported by the validator. (at /$schema)

t appears your tool schemas use JSON Schema draft 2020-12 features (like $dynamicRef), but the MCP client/validator only supports older drafts (like draft-07 or draft-04). As a result, the tools are omitted and cannot be used.
Could you please:
Update your tool schemas to use draft-07 or draft-04 (removing $dynamicRef and other unsupported features), or
Coordinate with the MCP client maintainers to add support for draft 2020-12 and $dynamicRef?
Thank you!

[PochyPoch]

I have the exact same issue with VS Code / Copilot chat :

2025-09-26 11:25:20.753 [info] Discovered 6 tools
2025-09-26 11:25:21.124 [warning] 6 tools have invalid JSON schemas and will be omitted
 
Tool `firecrawl_scrape` has invalid JSON parameters:
	- The schema uses meta-schema features ($dynamicRef) that are not yet supported by the validator. (at /$schema)
	- Schema: {"$schema":"[https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string",…][...]

[sai80082]

Yep same issue

[Leon-Weigel]

Same problem here

[azwri]

Guide: Enable Draft 2020-12 schema support for MCP in VS Code #118