firecrawl / firecrawl/firecrawl-mcp-server

MCP Integration Issue: "Cannot read properties of undefined (reading 'status')" Error When Calling firecrawl-mcp Tool from Cursor

Open
#20 6 comments 0 reactions 0 assignees View on GitHub
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

![Image](https://github.com/user-attachments/assets/83bd3269-329f-4edc-ab2f-72af1711406d)

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

![Image](https://github.com/user-attachments/assets/5e263b75-409a-4b40-b661-c3ec744f2b61)

```
{
"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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.