mcpscraper-memory-sdk (Python)

Official Python clients for the unified 375-tool mcpscraper.dev MCP catalog. The direct 148-tool Memory manifest remains checked for runtime compatibility.

Release history

This is a thin JSON-RPC client generated against ../../contracts/memory.tools.json, the public contract for the hosted API. It contains no product source — only typed request/response plumbing.

Install

pip install mcpscraper-memory-sdk

Usage

import os
from mcpscraper_memory import MemoryClient, MemoryApiError

client = MemoryClient(api_key=os.environ["MCP_SCRAPER_API_KEY"])

try:
    result = client.memory.search(query="competitor pricing pages")
    for hit in result.results or []:
        print(hit["source"], hit["score"])
except MemoryApiError as err:
    print(f"memory call failed: {err}")

Namespaces

client.access, client.capture, client.channels, client.crm, client.facts, client.files, client.graph, client.library, client.memory, client.recall, client.research, client.schedule, client.storage, client.tables, client.tags, client.vaults, client.video, client.webhooks — one method per tool, snake_case, typed with generated Pydantic models. Use Research for sourced knowledge and CRM for an actual relationship; counterpart operations link records without copying fields. External CRM providers remain unavailable, with no setup or write wrapper. Original Gmail attachment bytes saved to Memory are available through client.files.file_asset_save(...) and client.files.file_asset_get(...).

Use the same key with McpToolsClient for all 375 unified scraper and Memory tools.

Use client.call_tool_result(name, args) for native MCP image, audio, or resource blocks. The existing call_tool method keeps returning the parsed structured/text value.

The unified MCP client accepts pages=2 on client.other.harvest_paa_start(...). It keeps one page as the default, adds page-two organic results when available, and expands PAA only on the preserved first page. Poll the same job with harvest_paa_status; pagination remains nullable for results saved under older contracts.

Authentication

Set MCP_SCRAPER_API_KEY once. MemoryClient, McpToolsClient, and the scraper SDK all use that same customer credential against https://mcpscraper.dev/mcp.

Regenerating models

src/mcpscraper_memory/models/ and _generated_client.py are generated from ../../contracts/memory.tools.json. After editing the manifest, regenerate with:

python scripts/generate_models.py

Release files for mcpscraper-memory-sdk 0.38.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcpscraper-memory-sdk 0.38.0
File	Size	Uploaded
mcpscraper_memory_sdk-0.38.0.tar.gz	197.5 kB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcpscraper-memory-sdk 0.38.0
File	Interpreter	ABI	Platform	Reset
mcpscraper_memory_sdk-0.38.0-py3-none-any.whl 584.7 kB Sep 2, 2026	Python 3	none	any	Details

Total release size: 782.2 kB

Release files / mcpscraper_memory_sdk-0.38.0.tar.gz

Download URL	mcpscraper_memory_sdk-0.38.0.tar.gz
Size	197.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`213f80cac9fb756e579bb17fdb980bb71a422bcb308bf506827060dc769ce3b0`
BLAKE2b-256 checksum How to use checksums	`28aa0eaec3f77351fb389e53f01c8bf50e52fc89d9d7bf11d2bc485e779a2514`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.12`

Release files / mcpscraper_memory_sdk-0.38.0-py3-none-any.whl

Download URL	mcpscraper_memory_sdk-0.38.0-py3-none-any.whl
Size	584.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d54e62c45a6821826c3f7ad6262f218f06027d9398ec2db6d713f258c60503e9`
BLAKE2b-256 checksum How to use checksums	`891abfe473a22afe763fefdb5a3a0c5947c552cd0a2448320d369f6a6ad37c41`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.12`