ScraperCompany MCP server

Live hotel, Airbnb/Vrbo and flight prices as tools your AI agent can call. Price a hotel for the next 330 nights in one call, see every booking site's price for a stay next to the hotel's own website, pull guest reviews, and search Google Flights.

This is a remote MCP server: there is nothing to install or run. This repository holds the connection settings for each client and a few short examples. The server itself is hosted by ScraperCompany.

• Server URL: https://api.scrapercompany.com/mcp (Streamable HTTP)

• Sign-in: OAuth 2.1 in the browser, or an API key in the x-api-key header

• Official MCP Registry: com.scrapercompany/travel-data

• Docs: scrapercompany.com/docs/mcp · Pricing: scrapercompany.com/pricing

What you can ask

What are the cheapest nights at The Savoy in London over the next two months?

Is anyone selling the Park Hyatt Tokyo cheaper than the hotel's own website on 20 November?

Find Airbnbs in Lisbon for four guests in the first week of December and quote the total for the best three.

Summarise this month's 1- and 2-star reviews for my hotel and list the ones we haven't replied to.

Cheapest dates to fly Montreal to Paris in January, and what does that week cost at the hotel near the Louvre I like?

Related MCP server: @striderlabs/mcp-airbnb

Connect

New accounts get a free trial of 50 calls or 14 days, whichever ends first, with no card. Clients that support OAuth sign you in through the browser, so they need no key. For the others, create a key in the dashboard.

Claude (claude.ai, Claude Desktop, mobile)

Add ScraperCompany from the Claude directory, or add a custom connector with the URL https://mcp.scrapercompany.com/mcp and sign in. That address shows the read-only travel tools, which suit a chat assistant. If it does not resolve on your network, use https://api.scrapercompany.com/mcp/g/travel: it is the same server with the same tools.

Claude Code

With a key, read from your environment:

claude mcp add --transport http scrapercompany https://api.scrapercompany.com/mcp --header "x-api-key: $SCRAPERCOMPANY_API_KEY"

Without a key, run the command below, then finish the browser sign-in from /mcp inside Claude Code:

claude mcp add --transport http scrapercompany https://api.scrapercompany.com/mcp

To share the server with a project, copy .mcp.json into it. It reads the key from SCRAPERCOMPANY_API_KEY.

Cursor

Put mcp.json in ~/.cursor/mcp.json with your key in place of ${SCRAPERCOMPANY_API_KEY}. Use the key in Cursor rather than OAuth. This repository is also packaged as a Cursor plugin (.cursor-plugin/plugin.json), which asks for the key when you install it.

VS Code (GitHub Copilot)

Copy .vscode/mcp.json into your project. VS Code asks for the key the first time and keeps it in its secret storage.

ChatGPT

In developer mode, add an MCP server app with the URL https://api.scrapercompany.com/mcp/g/default, choose OAuth, and leave the client fields empty: the client registers itself.

Clients that only run local servers

Use the mcp-remote bridge, for example in claude_desktop_config.json:

{
  "mcpServers": {
    "scrapercompany": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.scrapercompany.com/mcp",
               "--header", "x-api-key:${SCRAPERCOMPANY_API_KEY}"],
      "env": { "SCRAPERCOMPANY_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Check the connection

Listing the tools is free:

curl -X POST https://api.scrapercompany.com/mcp \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

A 401 means the key is missing or wrong.

Tools

The default connection shows 24 read-only tools. Each tool description states its cost in credits. A call that fails or comes back empty costs nothing.

More tools, by group

Every tool belongs to a group. A long tool list costs your agent context in every conversation, so a connection only sees the groups named in its URL: https://api.scrapercompany.com/mcp/g/<group>,<group>. For example, /mcp/g/default,reviews adds every review tool to the default set.

Every tool is annotated. Only the monitoring and webhooks groups change data, and clients that ask before running write tools will ask before running those.

Examples

examples/ has three short Python scripts that call the server directly. They use only the standard library, so there is nothing to install:

export SCRAPERCOMPANY_API_KEY=sk_...
cd examples
python rate_calendar.py "The Savoy" London --days 60 --currency GBP              # 10 credits
python rate_parity.py "The Savoy" London --check-in 2026-11-06 --currency GBP --market GB   # 12 credits
python review_watch.py "The Savoy" London --pages 3 --max-rating 3               # 8 credits

rate_parity.py prints every seller's price for one night and flags the sellers that undercut the hotel's own website (a real run on 28 October 2026):

The Savoy, 2026-11-06, 1 night, 2 adults, GBP
  Vio.com                      688.99   -16.6% vs direct  <- undercuts the hotel
  Super.com                    696.34   -15.7% vs direct  <- undercuts the hotel
  ...
  Official site                826.50
  Booking.com                  870.00    +5.3% vs direct

examples/scrapercompany_mcp.py is the whole client: one JSON-RPC POST per tool call. The server is stateless, so there is no session to open first.

Hotel owners can also request a free rate parity check without writing any code.

Pricing

Plans start at $49 a month for 40,000 credits, and credit packs start at $15. A tool call costs the same as the REST API call it wraps. See pricing and the credit cost of every call.

Security

• Keep your key in an environment variable or your client's secret store, not in a config file you share or commit.

• OAuth access tokens last one hour and your client refreshes them. You can revoke a key in the dashboard at any time.

• Report a vulnerability to security@scrapercompany.com.

Support

support@scrapercompany.com · Status · REST API docs

License

The configuration files and examples in this repository are MIT licensed. Use of the ScraperCompany service is governed by its Terms of Service.