{
  "markdown": "<!-- mcp-name: io.github.quality-network/finedata-mcp -->\n\n# FineData MCP Server\n\nMCP (Model Context Protocol) server for [FineData](https://finedata.ai) web scraping API.\n\nEnables AI agents (Claude, Cursor, GPT, …) to fetch pages that need a full\nbrowser and return clean data:\n\n- JavaScript rendering and browser actions\n- Captcha solving\n- Datacenter / ISP / residential / mobile proxies\n- Markdown or JSON output (markdown by default)\n- AI structured extraction\n- Local **stdio** or remote **Streamable HTTP** (+ OAuth 2.1)\n\nVersion: **0.3.1**\n\n## Modes\n\nStart with a plain request. Stealth and proxy modes are available when a page\nneeds a full browser; they consume more tokens than a plain request. Exact\nrates are in the documentation and via `get_usage`. Gateway may apply a domain\nstrategy that overrides the requested engine or proxy; trust `tokens_used` in\nthe response.\n\n## Installation\n\n### uvx (recommended)\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nFINEDATA_API_KEY=fd_xxx uvx finedata-mcp\n```\n\n### pip\n\n```bash\npip install finedata-mcp\nFINEDATA_API_KEY=fd_xxx finedata-mcp\n```\n\n### npx\n\n```bash\nnpx -y @finedata/mcp-server\n```\n\n## Cursor\n\n`~/.cursor/mcp.json` (Windows: `%USERPROFILE%\\.cursor\\mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"finedata\": {\n      \"command\": \"uvx\",\n      \"args\": [\"finedata-mcp\"],\n      \"env\": {\n        \"FINEDATA_API_KEY\": \"fd_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nCursor deeplink (after publishing): install via MCP directory / “Add to Cursor”.\n\n### Remote (Streamable HTTP)\n\n```json\n{\n  \"mcpServers\": {\n    \"finedata\": {\n      \"url\": \"https://mcp.finedata.ai/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer fd_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nOAuth 2.1 (Claude.ai / ChatGPT connectors): register via AS at `https://api.finedata.ai`, consent in the cabinet, then use the access token as Bearer.\n\n## Environment\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `FINEDATA_API_KEY` | stdio: yes | — | API key |\n| `FINEDATA_API_URL` | no | `https://api.finedata.ai` | API base |\n| `FINEDATA_TIMEOUT` | no | `180` | HTTP client timeout (seconds) |\n| `FINEDATA_MCP_HOST` | HTTP | `0.0.0.0` | Bind host |\n| `FINEDATA_MCP_PORT` | HTTP | `8080` | Bind port |\n| `FINEDATA_OAUTH_ISSUER` | remote OAuth | — | AS URL (gateway) |\n| `FINEDATA_MCP_RESOURCE_URL` | remote OAuth | — | Public MCP URL |\n| `FINEDATA_JWT_SECRET` | remote OAuth | — | Verify `aud=mcp` JWTs |\n\n## Tools\n\n| Tool | Purpose |\n|------|---------|\n| `scrape_url` | Sync scrape with GET, read-only (markdown default) |\n| `send_http_request` | Sync POST / PUT / PATCH / DELETE through the same pipeline |\n| `scrape_async` | Async job, GET (`formats=['markdown']` default) |\n| `get_job_status` | Poll job (markdown, not raw HTML) |\n| `cancel_job` | Cancel job |\n| `list_jobs` | List jobs |\n| `batch_scrape` | Up to 100 URLs (string or `{url,...}` objects) |\n| `get_batch_status` | Batch progress |\n| `get_usage` | Period usage via `api_tokens_used` |\n\nNotable parameters: `use_antibot`, `proxy_country`, `proxy_sticky`, `proxy_profile_id`, `auto_retry`, stealth modes, `formats`, `only_main_content`, extract_*.\n\nAsync/batch: no `csv`/`xlsx` formats (sync only).\n\n## HTTP transport\n\n```bash\nfinedata-mcp --transport http --host 0.0.0.0 --port 8080\n```\n\nHealth: `GET /health`. Protected resource metadata is served at the path-scoped\nURL for the endpoint — `GET /.well-known/oauth-protected-resource/mcp` — because\n`FINEDATA_MCP_RESOURCE_URL` carries the `/mcp` path. Clients normally find it\nfrom the `WWW-Authenticate` header on a `401` rather than guessing.\n\n## Support\n\n- Docs: https://finedata.ai/docs\n- Issues: https://github.com/quality-network/finedata-mcp/issues\n\n## License\n\nMIT\n",
  "bytes": 3777,
  "sha": "50f2a383f42dbdefe72769535f6b0df7f4389a5bf324ba5238a192dc2b2cca56",
  "repo_slug": "quality-network/finedata-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_quality_network_finedata_mcp_b6228914/readme"
}