Skip to main content

mcpscraper-memory-sdk (Python)

Official Python clients for all 354 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 354 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.31.1

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.31.1
File Size Uploaded
mcpscraper_memory_sdk-0.31.1.tar.gz 174.1 kB Details

Built distribution (wheel)

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

Total release size: 685.2 kB

Release files / mcpscraper_memory_sdk-0.31.1.tar.gz

Download URL mcpscraper_memory_sdk-0.31.1.tar.gz
Size 174.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9887a9b8b5febd89b64d43a5419d428cbbf7f8a20a0a81676288c96ec0953f2b
BLAKE2b-256 checksum
How to use checksums
9140e54f2fc6c359dedcb9a6d33d8ccd9982e37f7e3a3580b39dd1d84b2981db
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.31.1-py3-none-any.whl

Download URL mcpscraper_memory_sdk-0.31.1-py3-none-any.whl
Size 511.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dd7fbe8648c3e16ec8f037351ed589a0c23b8555b0a360ff26b35bdedbeddfc8
BLAKE2b-256 checksum
How to use checksums
561023574594ff6d7e250ade1709fd68c7d91d64ca0c1f3d47f2b5ec67841043
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