Skip to main content

mcpscraper-memory-sdk (Python)

Official Python clients for all 356 unified mcpscraper.dev MCP tools plus the direct 121-tool memory.mcpscraper.dev API.

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

from mcpscraper_memory import MemoryClient, MemoryApiError

client = MemoryClient(api_key="mk_your_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.facts, client.files, client.graph, client.library, client.memory, client.recall, 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. Original Gmail attachment bytes saved to Memory are available through client.files.file_asset_save(...) and client.files.file_asset_get(...).

Use McpToolsClient(api_key="sk_...") for all 356 unified tools, including the governed personal-assistant namespace; it has the same generated namespaces as every other SDK package. The ZIP reader is available as client.web.archive_read(url=...), and the editorial workflow begins with client.editorial.reading_room_guide(focus="workflow"). Scheduled results and saved artifact templates are available under client.schedule; run IDs and cursors remain opaque. Bulk Gmail, Calendar, Zoom, Meta Marketing, and Resend exports are available through client.connections.export_connected_service_data(...); select meta_ads_insights for daily account/campaign/ad-set/ad reporting or resend_data for the Resend aggregate, and renew expired artifact URLs with client.connections.renew_connected_data_download(artifact_id="artifact_123").

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.

Don't have a memory key?

If you already have an mcpscraper.dev API key and don't want to provision a separate mk_... memory key, use mcpscraper-sdk's ScraperClient.memory_tools instead — it exposes this exact same set of 121 tools, dispatched through your scraper API key.

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

See also

Repo README (multi-language examples with real sample output) · mcpscraper-memory-sdk on npm (Node) · mcpscraper-sdk on PyPI (also reaches these 121 tools via a scraper key) · mcpscraper-cli

Release files for mcpscraper-memory-sdk 0.32.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.32.0
File Size Uploaded
mcpscraper_memory_sdk-0.32.0.tar.gz 183.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcpscraper-memory-sdk 0.32.0
File Interpreter ABI Platform
mcpscraper_memory_sdk-0.32.0-py3-none-any.whl Python 3 none any Details

Total release size: 722.7 kB

Release files / mcpscraper_memory_sdk-0.32.0.tar.gz

Download URL mcpscraper_memory_sdk-0.32.0.tar.gz
Size 183.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b59502c0076a15e44d445001dad4636eaced172ed9022997ca53268783b37f05
BLAKE2b-256 checksum
How to use checksums
f265e631485fc28eb90f762e828bbdfee5369290f54b9df331a8ed2a18322068
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

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

Download URL mcpscraper_memory_sdk-0.32.0-py3-none-any.whl
Size 538.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
661a91a57e5bc5ee05de00bb7a25e95e4cb43c594326128470dfe8d14900a590
BLAKE2b-256 checksum
How to use checksums
83457d63c17c04427372611d6d3234ccd8e57b52de2f994821598dbc49a9a809
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page