MCP server

MCP server overview

Use PyScrappy as a tool from Claude and other AI agents.

PyScrappy ships an optional Model Context Protocol server, so an AI agent (like Claude) can call PyScrappy's scrapers as tools and get structured web data back as validated JSON.

Install

pip install 'pyscrappy[mcp]'

This installs a pyscrappy-mcp command, a stdio MCP server. You can also run it with python -m pyscrappy.mcp.

The MCP server requires Python 3.10+.

Run it directly with uvx

You don't even need a local install. uvx can run it on demand:

uvx --from "pyscrappy[mcp]" pyscrappy-mcp

What you get

Once registered, the agent can call 22 tools that return a consistent ScrapeToolResult envelope (data, count, scraper, source_urls, errors). Just ask naturally:

"Use pyscrappy to get the latest headlines from bbc.co.uk and the AAPL stock quote."

Where PyScrappy is listed

Next