Euroscrape MCP Server

EuroScrape MCP server

Twenty data tools for AI agents: flight, hotel and electricity prices, second-hand marketplaces, company data and leads, EU and French open data. Each tool runs one of the EuroScrape Actors on Apify and returns structured JSON.

Works with Claude Desktop, Claude Code, Cursor, VS Code and any MCP client.

• Runs on your own Apify account. You pay Apify per result, at the price shown on each Actor's page. No subscription, nothing goes through us.
• A spending cap on every call (0.50 USD by default), so an agent cannot start an expensive run by mistake.
• Cautious defaults: an agent that forgets a limit gets 10 to 50 rows, not thousands.

Install

You need an Apify API token (Apify Console → Settings → API & Integrations). Apify's free plan includes 5 USD of usage per month.

Claude Desktop, in one click

Download euroscrape-mcp.mcpb and open it, or drag it into Settings → Extensions. Claude Desktop asks for your Apify API token and installs the server; nothing else to set up.

Any MCP client

With Node.js 18 or later, add this to your MCP client configuration (for Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "euroscrape": {
      "command": "npx",
      "args": ["-y", "github:EuroScrape/euroscrape-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

Claude Code:

claude mcp add --env APIFY_TOKEN=YOUR_APIFY_TOKEN euroscrape -- npx -y github:EuroScrape/euroscrape-mcp

Tools

Every tool description states its price. The full list of parameters is in tools.json.

What a call does

1. Starts the Actor on your Apify account with your arguments and the spending cap.
2. Waits for the run to finish (up to four minutes; after that, get_run_results picks it up).
3. Returns the first rows as JSON, summary rows first, with the total count and a link to the full dataset in Apify Console.

Settings

Optional environment variables:

Prefer a hosted server?

Apify hosts an MCP server that can load the same Actors, with OAuth and no local install:

https://mcp.apify.com?tools=euroscrape/eu-electricity-prices,euroscrape/google-flights-prices

This repository is the local alternative, with short tool names, cautious defaults and a spending cap.

Privacy Policy

The server runs on your computer and EuroScrape collects nothing through it: no analytics, no telemetry. Tool arguments and your Apify API token go only to the Apify API, so that the Actor runs on your own Apify account; the server writes nothing to disk. Full policy: euroscrape.github.io/apify-actors/privacy.html.

Development

npm install
npm test                                   # lists the tools and checks their schemas, no Apify call
APIFY_TOKEN=... node test/check.mjs --live # also runs one real, cheap call

Input examples, sample outputs and write-ups: euroscrape.github.io/apify-actors.

MIT license.