firecrawl / firecrawl/firecrawl-mcp-server

[Bug/Improvement] Editor/VS Code reports "invalid JSON parameters"

Open
#107 1 comment 2 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
7.5k
Forks
890
Avg merge
1d 11h
Merged PRs (30d)
14

Description

The MCP exposes JSON schemas that include newer JSON Schema meta-features. The JSON Schema validator used by VS Code / the extension doesn't support those features, so editors show "invalid JSON parameters" and the MCP tool schemas are rejected.

Reproduction: Use the MCP with VS Code / Copilot (or the extension that integrates MCP tools). The logs show messages like: "Tool firecrawl_scrape has invalid JSON parameters: The schema uses meta-schema features ($dynamicRef) that are not yet supported by the validator."

Can we make firecrawl backward compatible?
I am unable to use firecrawl mcp in Github Copilot currently
other ide like gemini cli and qwen cli throw error while tool call sometimes too

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reproducing the issue with the MCP in VS Code/Copilot and inspect the tool schemas reported as invalid. Focus on the $dynamicRef meta-feature mentioned in the logs; done means the exposed schemas are accepted by the affected validators and tool calls no longer intermittently fail in the reported clients.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
api, backend
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.