Register with a client

The pyscrappy-mcp server speaks stdio, so it works with any MCP client. Each section below is a complete walkthrough: add the server, restart, then confirm the 22 tools appear in that client's tool list, and make your first call.

Claude Code

1. Add the server. Run this in your terminal (not inside a claude session):

claude mcp add pyscrappy pyscrappy-mcp

Or run it with uvx and no prior install (needs uv):

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

2. Verify it connected. From your shell:

claude mcp list

You want to see:

pyscrappy: pyscrappy-mcp  ✓ Connected

3. See the tools. Start a session and open the MCP panel:

claude

Then, inside the session:

/mcp

Select pyscrappy and press Enter. You'll see the 22 tools listed (scrape_url, scrape_wikipedia, get_crypto, …).

4. Call one. Ask naturally:

"Use pyscrappy to get the top 5 crypto prices."

Claude asks permission the first time it calls a new tool; approve it. The tool call in the output is labeled pyscrappy so you can confirm it went through the server.

Claude Desktop

1. Open the config file.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it.

2. Add PyScrappy:

{
  "mcpServers": {
    "pyscrappy": {
      "command": "pyscrappy-mcp"
    }
  }
}

If you already have other servers, add pyscrappy as another key inside the existing mcpServers object — don't create a second mcpServers.

3. Restart Claude Desktop completely (quit and reopen, not just close the window).

4. Verify the tools. In the chat input, click the tools/plug icon (bottom of the message box). You should see pyscrappy listed with its 22 tools. You can also type /mcp to open the server panel and confirm the status is connected.

5. Call one:

"Use pyscrappy to fetch the latest headlines from bbc.co.uk."

OpenCode

1. Open (or create) your config. OpenCode reads opencode.json from your project root, or ~/.config/opencode/opencode.json for all projects. If it doesn't exist, create it.

2. Add PyScrappy to the mcp block:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pyscrappy": {
      "type": "local",
      "command": ["uvx", "--from", "pyscrappy[mcp]", "pyscrappy-mcp"],
      "enabled": true
    }
  }
}

If you already ran pip install 'pyscrappy[mcp]', you can use the console script directly: "command": ["pyscrappy-mcp"].

3. Restart OpenCode.

4. Verify the tools. In OpenCode, run:

/mcp

pyscrappy should appear as connected with its 22 tools. (You can also list tools with /tools in builds that support it.)

5. Call one:

"Use pyscrappy to search GitHub for popular Python scraping repositories."

OpenClaw

OpenClaw uses the same mcpServers format as Claude Desktop.

1. Open (or create) openclaw.json in your OpenClaw config directory.

2. Add PyScrappy:

{
  "mcpServers": {
    "pyscrappy": {
      "command": "pyscrappy-mcp"
    }
  }
}

Or, to run with no prior install:

{
  "mcpServers": {
    "pyscrappy": {
      "command": "uvx",
      "args": ["--from", "pyscrappy[mcp]", "pyscrappy-mcp"]
    }
  }
}

3. Restart OpenClaw.

4. Verify the tools via OpenClaw's MCP/tools panel (or /mcp) — pyscrappy should list its 22 tools.

5. Call one:

"Use pyscrappy to define the word 'ephemeral' and get today's weather in Tokyo."

Any other client (MCP Inspector)

To test the raw server against any MCP tooling, use the official MCP Inspector:

npx @modelcontextprotocol/inspector pyscrappy-mcp

It opens a browser UI. Under the Tools tab you'll see all 22 tools; select one, fill in its arguments, and click Run to see the ScrapeToolResult come back.

Providing the OMDb key

Only the lookup_movie tool needs a free OMDb API key. Every other tool works without it.

Claude Desktop / Claude Code / OpenClaw (the env key):

{
  "mcpServers": {
    "pyscrappy": {
      "command": "pyscrappy-mcp",
      "env": { "OMDB_API_KEY": "your-key" }
    }
  }
}

OpenCode (the environment key):

{
  "mcp": {
    "pyscrappy": {
      "type": "local",
      "command": ["uvx", "--from", "pyscrappy[mcp]", "pyscrappy-mcp"],
      "environment": { "OMDB_API_KEY": "your-key" }
    }
  }
}

Troubleshooting

The server shows up but lists zero tools. The process failed to start. Run the command yourself to see the error:

pyscrappy-mcp

It should start and wait silently (that's stdio waiting for a client). If it errors, the message names what's missing — usually the mcp extra:

pip install 'pyscrappy[mcp]'

"pyscrappy-mcp: command not found." The console script isn't on your client's PATH. Either use the uvx form (uvx --from "pyscrappy[mcp]" pyscrappy-mcp) or the absolute path from which pyscrappy-mcp.

The client can't find uvx. Install uv, or switch to the plain pyscrappy-mcp command after pip install 'pyscrappy[mcp]'.

Changes don't take effect. Restart the client fully — every client reads its MCP config only at startup.