firecrawl / firecrawl/firecrawl-mcp-server
MCP Integration Issue: "Cannot read properties of undefined (reading 'status')" Error When Calling firecrawl-mcp Tool from Cursor
- Dominant language
- JavaScript
- Stars
- 7.5k
- Forks
- 884
- Avg merge
- 1d 11h
- Merged PRs (30d)
- 14
Description
MCP Integration Issue: "Cannot read properties of undefined (reading 'status')" Error When Calling firecrawl-mcp Tool from Cursor
Description
Environment Information
Operating System: Windows
Local firecrawl version: v1.6.0
firecrawl-mcp version: 1.5.0
Cursor version: 0.47.5
Problem Description
I have successfully deployed firecrawl service locally using Docker Compose, and the API works normally when tested with curl. However, when I try to call firecrawl tools through Cursor's MCP service, I encounter a "Cannot read properties of undefined (reading 'status')" error.
Steps to Reproduce
1.Deploy firecrawl locally using Docker Compose
2.Configure MCP service in Cursor
```
{
"mcpServers":{
"firecrawl-mcp": {
"command": "C:\\Windows\\System32\\cmd.exe",
"args": [
"/c",
"set FIRECRAWL_API_URL=http://localhost:3002 && npx -y firecrawl-mcp"
],
"enabled": true
}
}
}
```
3.The MCP service successfully starts in the Cursor interface, showing the list of tools

4.Try to use the firecrawl_scrape tool to scrape web content

```
{
"url": "https://example.com",
"formats": [
"markdown"
],
"onlyMainContent": true
}
```
5.Receive error: "Cannot read properties of undefined (reading 'status')"
Verification Test
Using curl to directly call the local API works perfectly:
```
curl -X POST http://localhost:3002/v1/scrape \
-H 'Content-Type: application/json' \
-d '{"url":"https://example.com","formats":["markdown"],"onlyMainContent": true}'
```
Returns the correct result:
`{"success":true,"data":{"markdown":"Example Domain\n==============\n\nThis domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.\n\n[More information...](https://www.iana.org/domains/example)","metadata":{"viewport":"width=device-width, initial-scale=1","title":"Example Domain","scrapeId":"1402b3f9-d808-44f9-9db0-97b368d34c06","sourceURL":"https://example.com","url":"https://example.com","statusCode":200}}}`
Attempted Solutions
Updated the API path in the MCP configuration (tried both http://localhost:3002 and http://localhost:3002/v1)
Suspected Cause
The API response format expected by the MCP client (firecrawl-mcp 1.5.0) may not match what is provided by the local firecrawl API (v1.6.0), or there might be an issue with the environment variable setting method in the Windows environment.
Please provide guidance on how to resolve this compatibility issue, especially when using a locally deployed firecrawl service.
Contributor guide
No contributing guide indexed for this repository
Research direction
Reproduce the Windows setup using the supplied Cursor MCP configuration, firecrawl-mcp 1.5.0, local Firecrawl v1.6.0, and the /v1/scrape curl request. Compare the MCP tool’s handling of the local API response and FIRECRAWL_API_URL setting; done means firecrawl_scrape succeeds through Cursor with the documented payload.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker-compose, javascript
- Domain
- api, backend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100