mcpscraper-memory-sdk 0.13.0__py3-none-any.whl

mcpscraper_memory/mcp_models/table_list.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableListInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class TableListOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    tables: list[str] | None = Field(None, alias="tables", description="Table names owned by the caller. Present when ok is true; may be empty.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_query.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableQueryInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Table name, from table-list.")
+    filters: list[dict[str, Any]] | None = Field(None, alias="filters", description="Filters to AND together. Optional; omit to match every row.")
+    sort: dict[str, Any] | None = Field(None, alias="sort", description="Column to sort by. Optional; defaults to id ascending (insertion order).")
+    limit: int | None = Field(None, alias="limit", description="Max rows to return. Optional; default 100, max 2000.")
+    offset: int | None = Field(None, alias="offset", description="Rows to skip, for pagination. Optional; default 0.")
+
+
+class TableQueryOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/validation error.")
+    table_name: str | None = Field(None, alias="tableName", description="The table name.")
+    rows: list[dict[str, Any]] | None = Field(None, alias="rows", description="Matching rows, each an object of column name to value.")
+    count: float | None = Field(None, alias="count", description="Total rows matching the filters, before limit/offset — use for pagination.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/temporal_recall.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TemporalRecallInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str | None = Field(None, alias="vault", description="Vault to recall from. Optional; defaults to the session active vault, then the first vault the caller is entitled to.")
+    query: str | None = Field(None, alias="query", description="Optional natural-language query; when present, a semantic search is blended into the results.")
+    days_ago: int | None = Field(None, alias="daysAgo", description="Recall a single calendar day this many days ago (0 = today). Optional; ignored when from/to are given.")
+    from_: str | None = Field(None, alias="from", description="Start of an explicit window (ISO-8601 / parseable date). Use together with \"to\". Overrides daysAgo.")
+    to: str | None = Field(None, alias="to", description="End of an explicit window (ISO-8601 / parseable date). Use together with \"from\".")
+
+
+class TemporalRecallOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when recall succeeded; false on auth/scope error.")
+    range: dict[str, Any] | None = Field(None, alias="range", description="The actual time window used after resolving daysAgo/from/to (default: last 7 days).")
+    items: list[dict[str, Any]] | None = Field(None, alias="items", description="Captures within the window, newest-first. Present when ok is true.")
+    search_results: list[dict[str, Any]] | None = Field(None, alias="searchResults", description="Blended semantic-search hits for the query. Present only when a query was supplied.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/test_service_connection.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TestServiceConnectionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A tenant-owned connectionId from list_service_connections.")
+    provider_config_key: str | None = Field(None, alias="providerConfigKey", description="Optional provider hint from list_service_connections.")
+
+
+class TestServiceConnectionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/trustpilot_reviews.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TrustpilotReviewsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    domain: str = Field(..., alias="domain", description="The business's domain as it appears in its Trustpilot URL, e.g. \"www.bhphotovideo.com\" (include the www. if the site uses it — pass the domain as-is, do not guess).")
+    max_pages: int | None = Field(None, alias="maxPages", description="Review pages to fetch (~20 reviews per page). Default 5 (~100 reviews). Maximum 50 — large companies can have 1,000+ pages; this tool is for sampling, not full-corpus export.")
+
+
+class TrustpilotReviewsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/upsert_memory_tag.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class UpsertMemoryTagInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    tag: str = Field(..., alias="tag", description="")
+    description: str | None = Field(None, alias="description", description="")
+    aliases: list[str] | None = Field(None, alias="aliases", description="")
+    status: Literal["active", "deprecated"] | None = Field(None, alias="status", description="")
+
+
+class UpsertMemoryTagOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    tag: dict[str, Any] | None = Field(None, alias="tag", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/validate_memory_write.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ValidateMemoryWriteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="")
+    title: str = Field(..., alias="title", description="")
+    content: str = Field(..., alias="content", description="")
+    props: dict[str, Any] = Field(..., alias="props", description="")
+
+
+class ValidateMemoryWriteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    valid: bool | None = Field(None, alias="valid", description="")
+    errors: list[str] | None = Field(None, alias="errors", description="")
+    warnings: list[str] | None = Field(None, alias="warnings", description="")
+    normalized_tags: list[str] | None = Field(None, alias="normalizedTags", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/video_analyze_start.py

@@ -0,0 +1,21 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class VideoAnalyzeStartInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    source_url: str = Field(..., alias="sourceUrl", description="A YouTube, Facebook, Instagram, TikTok, or Vimeo URL (downloaded automatically), or a direct video file URL (.mp4/.webm/.mov/.gif).")
+    interval_s: float | None = Field(None, alias="intervalS", description="Preferred seconds between sampled frames (1-30). Default 2. For long videos the interval is automatically widened so the whole video is covered within the frame budget. Lower = denser sampling where the video is short enough to allow it.")
+    max_frames: int | None = Field(None, alias="maxFrames", description="Hard cap on frames analyzed (≤480). Default 120. Frames are spread across the whole duration; lowest sampling interval is 1 second, so short videos cannot use more frames than their length in seconds.")
+    detail: Literal["fast", "standard", "deep"] | None = Field(None, alias="detail", description="Analysis depth. Default standard.")
+    vault: str | None = Field(None, alias="vault", description="Vault to write the final breakdown note into. Default \"Library\". You must have write access.")
+
+
+class VideoAnalyzeStartOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    run_id: str | None = Field(None, alias="runId", description="")
+    poll: dict[str, Any] | None = Field(None, alias="poll", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/video_analyze_status.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class VideoAnalyzeStatusInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    run_id: str = Field(..., alias="runId", description="The runId returned by video-analyze-start.")
+
+
+class VideoAnalyzeStatusOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    status: str | None = Field(None, alias="status", description="")
+    progress: dict[str, Any] | None = Field(None, alias="progress", description="")
+    frame_count: float | None = Field(None, alias="frameCount", description="")
+    max_frames: float | None = Field(None, alias="maxFrames", description="")
+    cost_usd: float | None = Field(None, alias="costUsd", description="")
+    artifact_path: str | None = Field(None, alias="artifactPath", description="")
+    report: str | None = Field(None, alias="report", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/video_frame_analysis.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class VideoFrameAnalysisInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    source_url: str = Field(..., alias="sourceUrl", description="A YouTube, Facebook, Instagram, TikTok, or Vimeo URL (downloaded automatically), or a direct video file URL (.mp4/.webm/.mov). Videos up to 30 minutes are supported.")
+    interval_s: float | None = Field(None, alias="intervalS", description="Preferred seconds between sampled frames (1-30, default 2). Automatically widened for long videos so the whole duration is covered within the frame budget.")
+    max_frames: int | None = Field(None, alias="maxFrames", description="Max frames analyzed (<=480, default 120). $1 per 120 frames requested — 120=$1 … 480=$4 — automatically refunded down if the video cannot use them (minimum 1s between frames). Frames are spread evenly across the whole video.")
+    detail: Literal["fast", "standard", "deep"] | None = Field(None, alias="detail", description="Analysis depth. Default standard.")
+    vault: str | None = Field(None, alias="vault", description="Memory vault to save the finished breakdown into. Default \"Library\".")
+
+
+class VideoFrameAnalysisOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/video_frame_analysis_status.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class VideoFrameAnalysisStatusInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    run_id: str = Field(..., alias="runId", description="The runId returned by video_frame_analysis.")
+
+
+class VideoFrameAnalysisStatusOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_artifact_read.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowArtifactReadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    run_id: str = Field(..., alias="runId", description="Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself.")
+    artifact_id: str = Field(..., alias="artifactId", description="Artifact id from the run artifact list returned by workflow_run, workflow_step, or workflow_status. Use only a returned artifactId; do not construct one yourself.")
+    max_bytes: int | None = Field(None, alias="maxBytes", description="Maximum bytes of artifact text to return inline.")
+
+
+class WorkflowArtifactReadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_list.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowListInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    include_recipes: bool | None = Field(None, alias="includeRecipes", description="Include high-level AI-facing recipes (market analysis, ICP research, CRO audits, content gaps, etc).")
+
+
+class WorkflowListOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_run.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowRunInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    workflow_id: Literal["directory", "get-leads", "agent-packet", "local-competitive-audit", "map-comparison", "serp-comparison", "paa-expansion-brief", "ai-overview-language"] = Field(..., alias="workflowId", description="Workflow to run. Call workflow_list or workflow_suggest first when unsure.")
+    input: dict[str, Any] | None = Field(None, alias="input", description="Workflow-specific input object; shape depends on workflowId. Call workflow_list or workflow_suggest to see required fields.")
+    webhook_url: str | None = Field(None, alias="webhookUrl", description="Optional HTTPS webhook to receive the completed hosted workflow run event.")
+
+
+class WorkflowRunOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_status.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowStatusInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    run_id: str = Field(..., alias="runId", description="Workflow run id returned by workflow_run, workflow_step, or workflow_status. Use only a returned runId; do not construct one yourself.")
+
+
+class WorkflowStatusOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_step.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowStepInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    run_id: str = Field(..., alias="runId", description="Workflow run id returned by workflow_run/workflow_step/workflow_status. Advances the run by exactly one step.")
+
+
+class WorkflowStepOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/workflow_suggest.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class WorkflowSuggestInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    goal: str = Field(..., alias="goal", description="The user goal or job to route, e.g. \"market analysis for roofers in Tennessee\", \"ICP research for med spas\", \"CRO audit for this URL\", or \"brand design briefing\".")
+    query: str | None = Field(None, alias="query", description="Business category, niche, or Maps query when known.")
+    keyword: str | None = Field(None, alias="keyword", description="Search keyword, audience problem, or content topic when known.")
+    domain: str | None = Field(None, alias="domain", description="Target domain or brand domain when known.")
+    url: str | None = Field(None, alias="url", description="Target URL when the workflow should inspect a specific page.")
+    location: str | None = Field(None, alias="location", description="City/region/country for localized research, e.g. Denver, CO.")
+    state: str | None = Field(None, alias="state", description="US state abbreviation or name for state-wide market research.")
+    max_suggestions: int | None = Field(None, alias="maxSuggestions", description="Number of matching workflow recipes to return.")
+
+
+class WorkflowSuggestOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/youtube_harvest.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class YoutubeHarvestInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    mode: Literal["search", "channel"] = Field(..., alias="mode", description="Use search for topic/keyword requests. Use channel when the user provides @handle, channel ID, or channel URL.")
+    query: str | None = Field(None, alias="query", description="Required when mode is search. The YouTube search topic in the user’s words.")
+    channel_handle: str | None = Field(None, alias="channelHandle", description="YouTube channel handle, channel ID, or URL. Examples: @mkbhd, UC..., https://youtube.com/@mkbhd.")
+    max_videos: int | None = Field(None, alias="maxVideos", description="Number of videos to return. Default 50, maximum 500.")
+
+
+class YoutubeHarvestOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/youtube_transcribe.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class YoutubeTranscribeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    video_id: str | None = Field(None, alias="videoId", description="YouTube video ID, e.g. dQw4w9WgXcQ. Use only an ID returned by youtube_harvest or visible in a YouTube URL; do not invent one.")
+    url: str | None = Field(None, alias="url", description="Full YouTube URL. Use when the user pasted a URL instead of an ID. Provide videoId or url.")
+
+
+class YoutubeTranscribeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/zoom_create_meeting.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ZoomCreateMeetingInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A Zoom connectionId from list_service_connections, with actionsEnabled true.")
+    topic: str = Field(..., alias="topic", description="Meeting topic/title.")
+    start_date_time: str = Field(..., alias="startDateTime", description="Start time, ISO 8601, e.g. \"2026-07-15T09:00:00-06:00\".")
+    duration_minutes: int | None = Field(None, alias="durationMinutes", description="Meeting duration in minutes. Default 30.")
+    timezone: str | None = Field(None, alias="timezone", description="IANA timezone, e.g. \"America/Denver\".")
+    agenda: str = Field(..., alias="agenda", description="Required meeting description or agenda. Preserve the purpose and context supplied by the user.")
+
+
+class ZoomCreateMeetingOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/models/access_accept_share.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessAcceptShareInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    share_id: str = Field(..., alias="shareId", description="The shareId from note-inbox to accept.")
+
+
+class AccessAcceptShareOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/lookup error.")
+    share_id: str | None = Field(None, alias="shareId", description="The accepted share.")
+    owner: str | None = Field(None, alias="owner", description="Identity who shared the note.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_approve_sender.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessApproveSenderInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    sender_identity: str = Field(..., alias="senderIdentity", description="Identity (email or user id) to approve as a sender.")
+
+
+class AccessApproveSenderOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    sender: str | None = Field(None, alias="sender", description="The identity that was approved.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_decline_share.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessDeclineShareInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    share_id: str = Field(..., alias="shareId", description="The shareId from note-inbox to decline.")
+
+
+class AccessDeclineShareOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/lookup error.")
+    share_id: str | None = Field(None, alias="shareId", description="The declined share.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_inbox_settings.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessInboxSettingsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    allow_unapproved_senders: bool = Field(..., alias="allowUnapprovedSenders", description="Set true to accept invites/shares from anyone; false to require approval.")
+
+
+class AccessInboxSettingsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    allow_unapproved_senders: bool | None = Field(None, alias="allowUnapprovedSenders", description="The setting now in effect.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_invite_account.py

@@ -0,0 +1,23 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessInviteAccountInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    grantee_identity: str = Field(..., alias="granteeIdentity", description="Identity (email or user id) to invite into your full account.")
+    scope: dict[str, Any] | None = Field(None, alias="scope", description="Permissions to grant across your account. Optional; defaults to read+write (read, write, export, index, swap).")
+    revoke: bool | None = Field(None, alias="revoke", description="Set true to revoke an existing account invite for this grantee instead of granting one.")
+
+
+class AccessInviteAccountOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope error.")
+    grantee: str | None = Field(None, alias="grantee", description="The identity that was invited or revoked.")
+    granted: dict[str, Any] | None = Field(None, alias="granted", description="The permissions now in effect for the grantee. Absent on revoke.")
+    revoked: bool | None = Field(None, alias="revoked", description="True when an existing invite was removed.")
+    note: str | None = Field(None, alias="note", description="Guidance on next steps for the grantee.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_issue_key.py

@@ -0,0 +1,28 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessIssueKeyInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier used to resolve the active vault and per-session state. Optional; defaults to the current MCP session.")
+    grantee_identity: str = Field(..., alias="granteeIdentity", description="Identity that will own the newly issued key (e.g. an email or user id).")
+    vaults: list[str] = Field(..., alias="vaults", description="Vaults the new key is entitled to; the caller must already hold each. At least one required.")
+    scope: dict[str, Any] | None = Field(None, alias="scope", description="Scope grant (read/write/export/index/admin/swap). Optional; omit for least-privilege read-only.")
+    plan: Literal["free", "pro", "team", "enterprise"] | None = Field(None, alias="plan", description="Subscription plan carried by the key. Optional; defaults to free.")
+    expires_in_days: int | None = Field(None, alias="expiresInDays", description="Days until the key expires (1-3650). Optional; omit for a non-expiring key.")
+
+
+class AccessIssueKeyOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the key was issued; false on auth/scope error.")
+    key_id: str | None = Field(None, alias="keyId", description="Stable identifier of the issued key (safe to store/log).")
+    secret: str | None = Field(None, alias="secret", description="The key secret — RETURNED ONCE and never retrievable again. Capture it immediately.")
+    grantee: str | None = Field(None, alias="grantee", description="Identity the key was issued to.")
+    vaults: list[str] | None = Field(None, alias="vaults", description="Vaults the issued key is entitled to.")
+    scope: dict[str, Any] | None = Field(None, alias="scope", description="Normalized scope actually granted on the key.")
+    plan: str | None = Field(None, alias="plan", description="Subscription plan assigned to the key.")
+    expires_at: Any | None = Field(None, alias="expiresAt", description="ISO-8601 expiry timestamp, or null when the key does not expire.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_list_approved_senders.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessListApprovedSendersInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+
+
+class AccessListApprovedSendersOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    approved_senders: list[str] | None = Field(None, alias="approvedSenders", description="Identities approved to reach you.")
+    allow_unapproved_senders: bool | None = Field(None, alias="allowUnapprovedSenders", description="True if your inbox is open to anyone regardless of this list.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_list_keys.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessListKeysInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier used to resolve the active vault and per-session state. Optional; defaults to the current MCP session.")
+    vault: str | None = Field(None, alias="vault", description="Filter to keys entitled to this vault. Optional; omit to list across all vaults.")
+    plan: str | None = Field(None, alias="plan", description="Filter to keys on this plan (free/pro/team/enterprise). Optional; omit to list all plans.")
+
+
+class AccessListKeysOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the listing succeeded; false on auth/scope error.")
+    keys: list[dict[str, Any]] | None = Field(None, alias="keys", description="Key metadata for the caller identity. NEVER includes secrets. Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_note_inbox.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessNoteInboxInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+
+
+class AccessNoteInboxOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    pending: list[dict[str, Any]] | None = Field(None, alias="pending", description="Pending offers, oldest first. Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_remove_approved_sender.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessRemoveApprovedSenderInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    sender_identity: str = Field(..., alias="senderIdentity", description="Identity to remove from your approved-senders list.")
+
+
+class AccessRemoveApprovedSenderOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    sender: str | None = Field(None, alias="sender", description="The identity that was removed.")
+    removed: bool | None = Field(None, alias="removed", description="True when an existing approval was found and removed.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/models/access_revoke_key.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessRevokeKeyInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier used to resolve the active vault and per-session state. Optional; defaults to the current MCP session.")
+    key_id: str = Field(..., alias="keyId", description="Identifier of the key to revoke (from access-list-keys). Must be a key the caller owns or fully covers.")
+
+
+class AccessRevokeKeyOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the revoke operation completed; false on auth/scope error or not-found.")
+    key_id: str | None = Field(None, alias="keyId", description="The key that was targeted for revocation.")
+    revoked: bool | None = Field(None, alias="revoked", description="True if the key is now revoked.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false (e.g. \"key not found\").")

mcpscraper_memory/models/access_revoke_share.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AccessRevokeShareInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    api_key: str | None = Field(None, alias="apiKey", description="Caller API key (Bearer secret). Optional when the MCP session is already authenticated; the server resolves auth from the session.")
+    session_id: str | None = Field(None, alias="sessionId", description="Session identifier. Optional; defaults to the current MCP session.")
+    share_id: str = Field(..., alias="shareId", description="The shareId to revoke.")
+
+
+class AccessRevokeShareOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/lookup error.")
+    share_id: str | None = Field(None, alias="shareId", description="The revoked share.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")