@finedata/mcp-server

MCP Server for FineData web scraping API.

This is a Node.js wrapper that launches the Python MCP server.

Quick Start

# Set your API key and run
FINEDATA_API_KEY=fd_xxx npx -y @finedata/mcp-server

Configuration

Cursor IDE Setup

Step 1: Create or edit MCP config file:

macOS/Linux:

mkdir -p ~/.cursor && nano ~/.cursor/mcp.json

Windows: Edit %USERPROFILE%\.cursor\mcp.json

Step 2: Add FineData server (using uvx - recommended):

{
  "mcpServers": {
    "finedata": {
      "command": "uvx",
      "args": ["finedata-mcp"],
      "env": {
        "FINEDATA_API_KEY": "fd_your_api_key"
      }
    }
  }
}

Step 3: Restart Cursor

Step 4: Test it by asking:

"Scrape https://example.com and show me the title"

Using npx (alternative)

{
  "mcpServers": {
    "finedata": {
      "command": "npx",
      "args": ["-y", "@finedata/mcp-server"],
      "env": {
        "FINEDATA_API_KEY": "fd_your_api_key"
      }
    }
  }
}

Claude Desktop Setup

Step 1: Open config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 2: Add MCP server:

{
  "mcpServers": {
    "finedata": {
      "command": "uvx",
      "args": ["finedata-mcp"],
      "env": {
        "FINEDATA_API_KEY": "fd_your_api_key"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Requirements

• Node.js 18+ (for npx)
• uv (recommended) OR Python 3.10+

Install uv (Recommended)

curl -LsSf https://astral.sh/uv/install.sh | sh

uv provides uvx which runs Python tools in isolated environments automatically.

Features

• Antibot Bypass - Cloudflare, DataDome, PerimeterX
• JavaScript Rendering - Playwright for SPAs
• Captcha Solving - reCAPTCHA, hCaptcha, Turnstile
• Proxy Rotation - 87K+ datacenter + residential

Available Tools

| Tool | Description | |------|-------------| | scrape_url | Sync scraping with antibot, JS render, captcha | | scrape_async | Async scraping, returns job_id | | get_job_status | Check async job status | | batch_scrape | Batch scrape up to 100 URLs | | get_usage | Current token usage |

Troubleshooting

"No module named finedata_mcp"

Install uv and use uvx config instead:

curl -LsSf https://astral.sh/uv/install.sh | sh

"externally-managed-environment" error on macOS

Use uvx instead of npx:

{
  "command": "uvx",
  "args": ["finedata-mcp"]
}

MCP not working in Cursor

1. Check ~/.cursor/mcp.json is valid JSON
2. Restart Cursor
3. Check Output → MCP panel for errors

Get Your API Key

Sign up at finedata.ai to get your API key and free trial tokens.

Documentation

Full documentation: https://docs.finedata.ai

Issues

https://github.com/quality-network/finedata-mcp/issues

License

MIT