Skip to main content
Glama

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-eu/euroscrape-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

Claude Code:

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

Related MCP server: honestkit-mcp

Tools

Tool

What it returns

Actor

get_electricity_prices

Day-ahead electricity prices for 40+ European bidding zones, with the cheapest window of each day

eu-electricity-prices

search_flights

Google Flights prices for a route and dates, cheapest day to fly, typical price range

google-flights-prices

find_ryanair_fares

Ryanair fare calendar of a route, or every destination under a price cap from an airport

ryanair-low-fares

search_hotels

Google Hotels prices, optionally on every booking site

google-hotels-prices

search_second_hand_europe

One search on the top second-hand marketplace of 18 countries, prices in euros, median per country

eu-marketplace-deals

search_vinted

Vinted listings in up to 26 countries, prices with buyer fees

vinted-scraper

search_kleinanzeigen

Kleinanzeigen ads with a deal score against the market price

kleinanzeigen-scraper

find_new_companies_without_website

Newly registered companies (UK, France, five US states) with no website yet

no-website-leads

search_uk_companies

Companies House data by SIC code, town or incorporation date

uk-companies

search_french_companies

SIRENE data by activity, department and size

france-companies

validate_eu_vat_numbers

VIES check of EU VAT numbers, with an official consultation number

vat-validator

get_company_behind_website

The legal entity behind a European website, from its legal notice

company-identity

detect_website_tech_stack

Technologies used by a website (280+), with sales signals

website-intelligence

search_eu_public_tenders

Open tenders and contract awards in Europe and France

eu-public-tenders

get_france_property_sales

Real property sales in France (DVF), price per m2, energy class

france-property-prices

get_france_energy_ratings

Energy performance certificates of French homes (DPE)

france-energy-ratings

get_france_building_permits

Building permits in France (Sitadel), with the applicant company

france-building-permits

get_france_fuel_prices

Live fuel prices of the stations around a French city

france-fuel-prices

get_app_reviews

App Store and Google Play reviews by country

app-reviews

search_trusted_shops

Online shops listed on Trusted Shops, or the reviews of a shop

trusted-shops-scraper

get_run_results

The results of a call that was still running when it returned (free)

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:

Variable

Default

Meaning

EUROSCRAPE_MAX_USD_PER_CALL

0.5

Spending cap of one call, in USD (Apify stops the run when it is reached)

EUROSCRAPE_MAX_ITEMS

50

Rows returned to the agent per call (the full result stays in your dataset)

EUROSCRAPE_MAX_CHARS

40000

Size limit of one answer, to protect the agent's context

EUROSCRAPE_TIMEOUT_SECONDS

240

How long a call waits for the run

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.com/privacy.

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.com.

MIT license.

Available Tools

21 tools
detect_website_tech_stackWebsite Technology Stack Detector: Tech Stack API, CMS & LeadsB
Read-only

Detects the technologies of websites (280+: CMS, e-commerce, analytics, consent tools...) with the company identity from the legal notice and sales signals. Pay per result on your Apify account: run start $0.003, website analyzed $0.02, google search page $0.004.

Inputs: websites, includeIdentity.

find_new_companies_without_websiteNo-Website Leads: New Businesses Without a Website (US, UK, FR)A
Read-only

Companies registered in the last days in the UK, France and five US states (Texas, New York, Colorado, Connecticut, Oregon) that have no website yet, from official registers, with the creation date of their domain name when one exists. Companies only, no director names. Pay per result on your Apify account: run start $0.003, no-website lead $0.005, new company with a website, or undecided $0.002.

Inputs: output, maxItems, usStates, countries, +5 more.

find_ryanair_faresRyanair Low Fare Finder: Cheapest Days, Anywhere & AlertsA
Read-only

Ryanair fares: the cheapest fare per day for a route (fare calendar), or every destination under a price cap from an airport. Pay per result on your Apify account: run start $0.003, calendar fare $0.0005, destination deal $0.001.

Inputs: dateTo, months, routes, airports, +5 more.

get_app_reviewsApp Store Reviews Scraper + Google Play Reviews (All Countries)A
Read-only

App Store and Google Play reviews of an app in the countries you choose: rating, text, version, date, developer reply, and a summary by version and country. Pay per result on your Apify account: run start $0.003, review delivered $0.0002.

Inputs: apps, sortBy, appNames, countries, +2 more.

get_company_behind_websiteImpressum & Legal Notice Scraper: VAT, Registry, ContactsA
Read-only

Reads the legal notice or Impressum of European websites and returns the company behind each one: legal name and form, registry numbers, VAT ID, address, emails and phones. Pay per result on your Apify account: run start $0.003, website identified $0.004, google search page $0.004.

Inputs: websites, verifyInRegistry.

get_electricity_pricesEU Electricity Prices API: Day-Ahead Power Prices & Cheap HoursA
Read-only

Day-ahead electricity prices for 40+ European bidding zones, hourly or 15-minute, with a summary per zone and day: cheapest window, minimum, maximum, average, negative-price hours. Without dates: today and tomorrow (tomorrow is published around 13:00 CET). Pay per result on your Apify account: run start $0.003, price row $0.0002.

Inputs: zones, dateTo, dateFrom, resolution, +1 more.

get_france_building_permitsFrance Building Permits (Sitadel): Projects, Builders & AlertsB
Read-only

Building permits in a French city or department (official Sitadel register): project, dwellings, floor area, status, and the applicant company with its SIREN. Pay per result on your Apify account: run start $0.003, building permit $0.003.

Inputs: statuses, locations, monthsBack, permitTypes, +3 more.

get_france_energy_ratingsFrance Energy Ratings (DPE): Homes, Energy Certificates, SievesA
Read-only

Energy performance certificates (DPE, ADEME open data) of homes in a French city or postal code: energy and CO2 class, surface, consumption, estimated yearly bill. Pay per result on your Apify account: run start $0.003, energy rating $0.001.

Inputs: ratings, locations, propertyType, maxRatingsPerLocation.

get_france_fuel_pricesFrance Fuel Prices: Gas Station Prices, Diesel Prices & AlertsA
Read-only

Live official fuel prices of the stations around a French city, postal code or GPS point, cheapest first, with the local spread. Pay per result on your Apify account: run start $0.003, station $0.001.

Inputs: fuels, radiusKm, locations, maxStationsPerLocation.

get_france_property_salesFrance Real Estate Sold Prices (DVF): €/m², Sales & TrendsA
Read-only

Real property sales in France (official DVF data) for a city or postal code: price paid, price per m2, surface, rooms, date, with the energy class of the home when known and a median price summary. Pay per result on your Apify account: run start $0.003, property sale $0.0005.

Inputs: years, locations, maxSurface, minSurface, +4 more.

get_run_resultsA
Read-only

Fetches the results of a previous call that was still running when it returned (use the runId it gave you). Free: no new run is started.

Inputs: runId (required).

search_eu_public_tendersEU Public Tenders Scraper: TED, BOAMP, Awards & Tender AlertsA
Read-only

Public tenders and contract awards in Europe (TED) and France (BOAMP, DECP) by keyword, CPV code and country: buyer, value in euros, deadline; for awards, the winner, the amount and the number of bids. Pay per result on your Apify account: run start $0.003, open tender delivered $0.003, contract award delivered $0.005.

Inputs: mode, cpvCodes, keywords, language, +5 more.

search_flightsGoogle Flights Scraper: Cheapest Dates, Prices & Price HistoryA
Read-only

Flight prices from Google Flights for a route and one or several departure dates: airlines, times, stops, price, and the typical price range of the route. Use numberOfDates with cheapestOnly to find the cheapest day to fly. Pay per result on your Apify account: run start $0.003, flight delivered $0.002.

Inputs: adults, routes, currency, maxStops, +7 more.

search_french_companiesFrench Companies Scraper: SIRENE Leads, Directors & EmailsA
Read-only

French companies from the official SIRENE register by activity (NAF code or keyword), department and size: legal data, headquarters, directors, and optionally a verified website with emails and phones. Pay per result on your Apify account: run start $0.003, company $0.004, website & contacts found $0.025.

Inputs: query, maxItems, nafCodes, departments, +4 more.

search_hotelsGoogle Hotels Scraper (Google Travel): Prices on Booking SitesA
Read-only

Hotel prices from Google Hotels for a destination or for named hotels and dates: price per night and total, rating, stars. With includeBookingSites, the price of each hotel on every booking site (official site, Booking.com, Expedia...). Pay per result on your Apify account: run start $0.003, hotel price $0.002, booking-site prices $0.003.

Inputs: adults, hotels, nights, sortBy, +6 more.

search_kleinanzeigenKleinanzeigen Scraper & Kleinanzeigen API: Deals & AlertsA
Read-only

Ads from Kleinanzeigen (Germany): price, location, posting time, and a 0-100 deal score against the market price. Pay per result on your Apify account: run start $0.003, ad $0.002, ad with full details $0.004.

Inputs: keywords, maxItems, maxPrice, minPrice, +4 more.

search_second_hand_europeEU Second-Hand Marketplaces Scraper: Vinted, OLX & MoreA
Read-only

One search on the biggest second-hand marketplace of up to 18 European countries (Kleinanzeigen, Marktplaats, Subito, Wallapop, OLX, Blocket, FINN...): listings with prices converted to euros, a deal score, and the median price per country. Pay per result on your Apify account: run start $0.003, listing delivered $0.002.

Inputs: sortBy, maxPrice, minPrice, countries, +2 more.

search_trusted_shopsTrusted Shops Scraper: Shop Leads, Ratings, Reviews & AlertsA
Read-only

Online shops listed on Trusted Shops by keyword and country (company, contact, rating, review volume), or the latest customer reviews of a given shop. Pay per result on your Apify account: run start $0.003, shop $0.002, company profile $0.004, review $0.0006.

Inputs: shops, countries, minReviews, searchTerms, +2 more.

search_uk_companiesUK Companies House API & Scraper: UK Company Data & B2B LeadsA
Read-only

UK companies from Companies House by SIC code, town or incorporation date: profile, registered office, officers, and optionally website, emails and phones. Pay per result on your Apify account: run start $0.003, company $0.004, website & contacts found $0.025.

Inputs: location, maxItems, sicCodes, statuses, +4 more.

search_vintedVinted Scraper & Vinted API: 26 Countries, Deals & AlertsA
Read-only

Vinted listings in up to 26 countries: price with buyer fees, brand, size, condition, seller rating, and a cross-country price summary. Pay per result on your Apify account: run start $0.003, item $0.001, item with full details $0.002, sold listing detected $0.002.

Inputs: order, priceMax, priceMin, searches, +4 more.

validate_eu_vat_numbersEU VAT Number Validator (VIES): Bulk Check, Proof & AlertsA
Read-only

Checks EU VAT numbers against VIES, the European Commission's registry: valid or not, registered name and address. With requesterVatNumber, each check returns an official consultation number. Pay per result on your Apify account: run start $0.003, vat number checked $0.002.

Inputs: vatNumbers, requesterVatNumber.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation3/5

    Each tool targets a different dataset, but several boundaries blur: search_kleinanzeigen overlaps with search_second_hand_europe (which already explicitly covers Kleinanzeigen), search_flights overlaps with find_ryanair_fares, and find_new_companies_without_website overlaps with the UK/French company-register searches. get_company_behind_website and detect_website_tech_stack also both return company identity from legal notices, so an agent must read long descriptions to pick correctly.

    Naming Consistency4/5

    All names are snake_case verb_noun (find_*, get_*, search_*, validate_*, detect_*), and the verb choice roughly tracks intent: find for discovery, search for querying a source, get for direct retrieval. Minor deviation: the same retrieval intent splits across find/search/get without a stated rule, and get_france_* prefixes are inconsistent with the plain search_uk_companies / search_french_companies pair.

    Tool Count4/5

    21 is on the heavy side, but this is a multi-source data marketplace where each tool corresponds to a genuinely separate dataset (electricity, flights, hotels, registries, tenders, property, fuel, reviews) rather than a redundant CRUD set. The only clearly redundant pair is search_kleinanzeigen alongside search_second_hand_europe.

    Completeness4/5

    get_run_results closes the main async gap by fetching late results and is free, so agents are not left with dangling runs. Remaining gaps are minor: no run-status/cancel or dataset listing tool, and heavy geographic asymmetry (four France-specific tools, no German/Spanish company-registry equivalents), which agents must work around via the pan-European search tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with real-time web capabilities including live search results, markdown web scraping, business lead generation, and detailed company information. It enables agents to bypass knowledge cutoffs by accessing current web data through a monetized Apify Actor.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to access fourteen web-data tools for scraping, SEO and site auditing, extraction, validation, enrichment, and screenshots through Apify actors. It runs those tools on the user's own Apify account via an API token.
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Gives AI agents twenty tools that run EuroScrape Actors on the user's own Apify account, returning structured JSON on flight, hotel and electricity prices, second-hand marketplace listings, company records and leads, public tenders, VAT validation, and French open data. Every call is capped by a spending limit and cautious default row counts to keep runs cheap and safe.
      21
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and retrieve government contracts, job postings, LinkedIn profiles, YC startups, contact details, tech stacks, PDF text, and Google Trends through 13 integrated tools. It returns compact JSON, handles long-running queries with progress and run results paging, and runs the underlying scrapers on the user's Apify account.
      MIT