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

mcpscraper_memory/mcp_models/prepare_memory_write.py

@@ -0,0 +1,26 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class PrepareMemoryWriteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    title: str = Field(..., alias="title", description="")
+    content: str = Field(..., alias="content", description="")
+    source: str | None = Field(None, alias="source", description="")
+    type: str | None = Field(None, alias="type", description="")
+    vault: str | None = Field(None, alias="vault", description="")
+    tag_candidates: list[dict[str, Any]] | None = Field(None, alias="tagCandidates", description="")
+    max_links: int | None = Field(None, alias="maxLinks", description="")
+
+
+class PrepareMemoryWriteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    route: dict[str, Any] | None = Field(None, alias="route", description="")
+    contract: dict[str, Any] | None = Field(None, alias="contract", description="")
+    tag_resolutions: list[dict[str, Any]] | None = Field(None, alias="tagResolutions", description="")
+    link_opportunities: list[dict[str, Any]] | None = Field(None, alias="linkOpportunities", description="")
+    instructions: list[str] | None = Field(None, alias="instructions", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/propose_scheduled_action.py

@@ -0,0 +1,21 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ProposeScheduledActionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    request: str = Field(..., alias="request", description="Freeform text describing what you want scheduled.")
+
+
+class ProposeScheduledActionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    description: str | None = Field(None, alias="description", description="Proposed description — edit freely before confirming.")
+    vault: str | None = Field(None, alias="vault", description="Proposed target vault.")
+    cadence: str | None = Field(None, alias="cadence", description="Proposed cadence: once, daily, weekly, or monthly.")
+    time_of_day: str | None = Field(None, alias="timeOfDay", description="Proposed 24-hour HH:MM run time, when the request named one.")
+    timezone: str | None = Field(None, alias="timezone", description="Proposed IANA timezone — from the request, or the account default when the request named a time without a zone.")
+    rationale: str | None = Field(None, alias="rationale", description="Why these choices were made — read this before confirming.")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/provision_defaults.py

@@ -0,0 +1,23 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ProvisionDefaultsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    grantee_identity: str = Field(..., alias="granteeIdentity", description="Identity that should OWN the 14 default vaults (e.g. an email or user id).")
+    issue_key: bool | None = Field(None, alias="issueKey", description="When true, also issue a new API key for the identity entitled to all 14 vaults and return its secret once. Default false.")
+    plan: Literal["free", "pro", "team", "enterprise"] | None = Field(None, alias="plan", description="Subscription plan carried by the issued key. Optional; defaults to free. Only used when issueKey is true.")
+
+
+class ProvisionDefaultsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when provisioning succeeded; false on auth/scope error.")
+    identity: str | None = Field(None, alias="identity", description="Identity the vaults were provisioned for.")
+    created: list[str] | None = Field(None, alias="created", description="Vault names newly created on this call (empty when all 14 already existed).")
+    vaults: list[str] | None = Field(None, alias="vaults", description="All 14 default vault names the identity now owns.")
+    key_id: str | None = Field(None, alias="keyId", description="Stable id of the issued key. Present only when issueKey was true.")
+    secret: str | None = Field(None, alias="secret", description="The issued key secret — RETURNED ONCE. Present only when issueKey was true.")
+    plan: str | None = Field(None, alias="plan", description="Plan assigned to the issued key. Present only when issueKey was true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/query_fanout_workflow.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class QueryFanoutWorkflowInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="Session id from browser_open. Must be on chatgpt.com or claude.ai, logged in via a saved hosted profile.")
+    prompt: str | None = Field(None, alias="prompt", description="Optional prompt to type and submit before capturing. Omit to passively capture a prompt the user just ran. Must trigger web search to produce a fan-out.")
+    wait_ms: int | None = Field(None, alias="wait_ms", description="How long to wait for the answer stream to finish. Defaults to 90000 when a prompt is sent, 8000 for passive capture.")
+    first_party_domain: str | None = Field(None, alias="first_party_domain", description="The brand/site being researched, e.g. example.com — sources on this domain are tagged First-party/vendor.")
+    reset: bool | None = Field(None, alias="reset", description="Clear any previously buffered stream for this page before capturing.")
+    export: bool | None = Field(None, alias="export", description="Write JSON/CSV/TSV/HTML exports to MCP_SCRAPER_OUTPUT_DIR/fanout, returning relative paths.")
+
+
+class QueryFanoutWorkflowOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/rank_tracker_workflow.py

@@ -0,0 +1,26 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RankTrackerWorkflowInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    project_name: str | None = Field(None, alias="projectName", description="Optional name for the rank tracker project, client, or campaign.")
+    target_domain: str | None = Field(None, alias="targetDomain", description="Primary domain to track in organic results, AI Overview citations, and PAA sources.")
+    target_business_name: str | None = Field(None, alias="targetBusinessName", description="Primary Google Business Profile/brand name to match in Maps results. Required for Maps tracking.")
+    tracking_modes: list[Literal["maps", "organic", "ai_overview", "paa"]] | None = Field(None, alias="trackingModes", description="Rank tracker surfaces to build: maps, organic, ai_overview, paa.")
+    keywords: list[str] | None = Field(None, alias="keywords", description="Seed keywords or service queries to track. Leave empty to derive from user input downstream.")
+    locations: list[str] | None = Field(None, alias="locations", description="Markets, cities, ZIPs, or service areas to track, e.g. \"Denver, CO\".")
+    competitors: list[str] | None = Field(None, alias="competitors", description="Optional competitor domains or business names to persist as comparison targets.")
+    database: Literal["postgres", "neon", "supabase", "sqlite", "mysql"] | None = Field(None, alias="database", description="Database family to target when generating migrations.")
+    schedule_cadence: Literal["daily", "weekly", "monthly", "custom"] | None = Field(None, alias="scheduleCadence", description="Default recurring rank check cadence.")
+    custom_cron: str | None = Field(None, alias="customCron", description="Cron expression to use when scheduleCadence is custom.")
+    timezone: str | None = Field(None, alias="timezone", description="IANA timezone for scheduled rank checks.")
+    include_cron: bool | None = Field(None, alias="includeCron", description="Include a cron/heartbeat worker plan.")
+    include_dashboard: bool | None = Field(None, alias="includeDashboard", description="Include dashboard/reporting requirements.")
+    include_alerts: bool | None = Field(None, alias="includeAlerts", description="Include alert rules for rank movement and SERP feature changes.")
+    notes: str | None = Field(None, alias="notes", description="Extra product, client, stack, or hosting requirements.")
+
+
+class RankTrackerWorkflowOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/react_message.py

@@ -0,0 +1,21 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ReactMessageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="The channel (vault) the message is in.")
+    message_id: str = Field(..., alias="messageId", description="The message or reply to react to (from post-message, reply-message, or list-channel-messages).")
+    emoji: str = Field(..., alias="emoji", description="The emoji to add or remove, e.g. \"👍\".")
+    remove: bool | None = Field(None, alias="remove", description="Set true to remove a reaction you previously added. Default false (add).")
+
+
+class ReactMessageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope error.")
+    message_id: str | None = Field(None, alias="messageId", description="The message reacted to.")
+    emoji: str | None = Field(None, alias="emoji", description="The emoji applied or removed.")
+    removed: bool | None = Field(None, alias="removed", description="True if this call removed a reaction; false if it added one.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/read_service_connection.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ReadServiceConnectionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A connectionId from list_service_connections.")
+    tool: str = Field(..., alias="tool", description="One of that connection's readTools (from list_service_connections). An unlisted tool name is rejected with the allowed list.")
+    args: dict[str, Any] | None = Field(None, alias="args", description="Arguments for the tool, if it needs any (e.g. a channel id, a date filter).")
+
+
+class ReadServiceConnectionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/record_fact.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RecordFactInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str | None = Field(None, alias="vault", description="Vault to record the fact in. Optional; defaults to the session active vault, then the first vault the caller is entitled to.")
+    subject: str = Field(..., alias="subject", description="The thing the fact is about (e.g. \"db preference\"). Canonicalized (lowercased/trimmed) to a stable key.")
+    value: str = Field(..., alias="value", description="The current asserted value or conclusion for the subject (e.g. \"Postgres\").")
+    source: str | None = Field(None, alias="source", description="Where the fact came from: user / tool / chat / library:… . Optional; drives the source-priority precedence policy.")
+    confidence: float | None = Field(None, alias="confidence", description="Salience/confidence in 0..1 on write. Optional; defaults to 0.5.")
+    reason: str | None = Field(None, alias="reason", description="Why this assertion replaces the previous one — the audit reason recorded on the superseded fact. Optional; a default is used.")
+
+
+class RecordFactOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the fact was recorded (whether or not it superseded one); false on auth/scope/validation error.")
+    fact: dict[str, Any] | None = Field(None, alias="fact", description="The new (or refreshed) active fact. Present when ok is true.")
+    superseded: Any | None = Field(None, alias="superseded", description="The previously-active fact that this one replaced, with its resolution/precedence. Absent on an idempotent no-op or first assertion.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/reddit_thread.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RedditThreadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="A reddit.com thread/post URL (www, old, new Reddit, or redd.it).")
+    max_comments: int | None = Field(None, alias="maxComments", description="Optional cap on comments returned. Omit to return all captured comments.")
+
+
+class RedditThreadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/remove_channel_member.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RemoveChannelMemberInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="The vault (channel) to remove the member from. You must own it.")
+    identity: str = Field(..., alias="identity", description="The member to remove.")
+
+
+class RemoveChannelMemberOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/ownership error.")
+    removed: bool | None = Field(None, alias="removed", description="True if a membership was found and removed; false if they were not a member.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/renew_connected_data_download.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RenewConnectedDataDownloadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    artifact_id: str = Field(..., alias="artifactId", description="Private artifactId returned by export_connected_service_data or export_search_console_table_data.")
+
+
+class RenewConnectedDataDownloadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/reply_message.py

@@ -0,0 +1,21 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ReplyMessageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="The channel (vault) the parent message is in.")
+    parent_message_id: str = Field(..., alias="parentMessageId", description="The top-level message to reply under (messageId from post-message or list-channel-messages).")
+    content: str = Field(..., alias="content", description="The reply text.")
+    attach_note: dict[str, Any] | None = Field(None, alias="attachNote", description="Attach one of your own notes to this reply, auto-shared with every current channel member. Optional.")
+
+
+class ReplyMessageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the reply was posted; false on auth/scope/lookup error.")
+    message_id: str | None = Field(None, alias="messageId", description="Path-style identifier for this reply (e.g. for react-message).")
+    posted_at: str | None = Field(None, alias="postedAt", description="ISO-8601 timestamp the reply was posted.")
+    attached_note: dict[str, Any] | None = Field(None, alias="attachedNote", description="Present when attachNote was given and the share succeeded.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/report_artifact_read.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ReportArtifactReadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    artifact_id: str = Field(..., alias="artifactId", description="Artifact id returned inline by a tool whose result was too large to inline. Use only a returned artifactId; do not construct one yourself.")
+    offset: int | None = Field(None, alias="offset", description="Byte offset to start reading from. Pass the previous call's nextOffset to continue.")
+    max_bytes: int | None = Field(None, alias="maxBytes", description="Maximum bytes of artifact text to return in this window.")
+
+
+class ReportArtifactReadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/resolve_memory_tags.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ResolveMemoryTagsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    candidates: list[dict[str, Any]] = Field(..., alias="candidates", description="")
+
+
+class ResolveMemoryTagsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    resolutions: list[dict[str, Any]] | None = Field(None, alias="resolutions", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/resume_scheduled_action.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ResumeScheduledActionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    id: str = Field(..., alias="id", description="The scheduled action id.")
+
+
+class ResumeScheduledActionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    next_run_at: str | None = Field(None, alias="nextRunAt", description="")
+    code: str | None = Field(None, alias="code", description="Machine-readable denial code when the action cannot be resumed.")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/revoke_chat_link.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RevokeChatLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class RevokeChatLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    revoked: bool | None = Field(None, alias="revoked", description="True if a link existed and was revoked; false if there was none to revoke.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/revoke_schedule_link.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RevokeScheduleLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class RevokeScheduleLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    revoked: bool | None = Field(None, alias="revoked", description="True if a link existed and was revoked; false if there was none to revoke.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/revoke_vault_app_link.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RevokeVaultAppLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class RevokeVaultAppLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the request succeeded.")
+    revoked: bool | None = Field(None, alias="revoked", description="True when an active Vault App link was revoked.")
+    error: str | None = Field(None, alias="error", description="Human-readable error when the request cannot be completed.")

mcpscraper_memory/mcp_models/revoke_webhook.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RevokeWebhookInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    id: str = Field(..., alias="id", description="Webhook id, from list-webhooks.")
+
+
+class RevokeWebhookOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    revoked: bool | None = Field(None, alias="revoked", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/route_memory.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RouteMemoryInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    title: str = Field(..., alias="title", description="")
+    content: str = Field(..., alias="content", description="")
+    type: str | None = Field(None, alias="type", description="")
+    source: str | None = Field(None, alias="source", description="")
+
+
+class RouteMemoryOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    vault: str | None = Field(None, alias="vault", description="")
+    folder: str | None = Field(None, alias="folder", description="")
+    reason: str | None = Field(None, alias="reason", description="")
+    contract: dict[str, Any] | None = Field(None, alias="contract", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/search_serp.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SearchSerpInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="The search query. KEEP the place in the query text for localized results (e.g. \"best dentist Brooklyn NY\") and also set location — city-in-query is what localizes reliably.")
+    location: str | None = Field(None, alias="location", description="City, region, or country for geo signals. Set alongside city-in-query wording; alone it does NOT reliably localize.")
+    gl: str | None = Field(None, alias="gl", description="Google country code inferred from location or user language.")
+    hl: str | None = Field(None, alias="hl", description="Google interface/content language inferred from user request.")
+    device: Literal["desktop", "mobile"] | None = Field(None, alias="device", description="SERP device context. Use mobile only for mobile rankings.")
+    proxy_mode: Literal["location", "configured", "none"] | None = Field(None, alias="proxyMode", description="Leave unset (clean egress). Do NOT set \"location\" just because a city was named — that comes from city-in-query wording. \"location\" forces residential geo-IP for rank-tracking fidelity, is frequently CAPTCHA-blocked, and accepts failures.")
+    proxy_zip: str | None = Field(None, alias="proxyZip", description="US ZIP for residential geo-IP targeting. Only meaningful with proxyMode \"location\".")
+    debug: bool | None = Field(None, alias="debug", description="Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior.")
+    pages: int | None = Field(None, alias="pages", description="Number of result pages to fetch (1–2).")
+
+
+class SearchSerpOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/set_agent_identity.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SetAgentIdentityInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    is_agent: bool = Field(..., alias="isAgent", description="true to mark this identity as an AI agent; false to unmark it.")
+
+
+class SetAgentIdentityOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    is_agent: bool | None = Field(None, alias="isAgent", description="The flag now in effect.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/set_schedule_defaults.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SetScheduleDefaultsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    default_timezone: Any = Field(..., alias="defaultTimezone", description="IANA timezone name, e.g. \"America/Denver\". null clears the default (new schedules fall back to UTC).")
+
+
+class SetScheduleDefaultsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    default_timezone: Any | None = Field(None, alias="defaultTimezone", description="The default timezone now in effect; null means UTC.")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/set_schedule_entitlement.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SetScheduleEntitlementInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    grantee_identity: str = Field(..., alias="granteeIdentity", description="Identity whose scheduling entitlement is being set (e.g. an email).")
+    enabled: bool | None = Field(None, alias="enabled", description="Historical entitlement value for migration/recovery only. Omit to preserve the stored value.")
+    quota_per_period: float | None = Field(None, alias="quotaPerPeriod", description="Historical monthly quota for migration/recovery only. Omit to preserve the stored value.")
+    mcp_scraper_api_key: str | None = Field(None, alias="mcpScraperApiKey", description="The identity's mcp-scraper API key, stored encrypted, used to reach mcp-scraper tools during scheduled-action execution.")
+
+
+class SetScheduleEntitlementOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the entitlement was set; false on auth/scope error.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/set_scheduled_action_connections.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SetScheduledActionConnectionsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    schedule_action_id: str = Field(..., alias="scheduleActionId", description="A scheduled action id returned by create-scheduled-action or list-scheduled-actions.")
+    connections: list[dict[str, Any]] = Field(..., alias="connections", description="Exact connection and tool grants for this schedule. Pass an empty array to remove every external-service grant.")
+
+
+class SetScheduledActionConnectionsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/slack_send_message.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SlackSendMessageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A Slack connectionId from list_service_connections, with actionsEnabled true.")
+    channel: str = Field(..., alias="channel", description="Slack channel ID to send to, e.g. \"C1234567890\". Get this from the connection's own read tools, not guessed.")
+    text: str = Field(..., alias="text", description="Message text to send.")
+
+
+class SlackSendMessageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/storage_usage.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class StorageUsageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class StorageUsageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when usage was computed; false on an auth/scope error.")
+    total_bytes: float | None = Field(None, alias="totalBytes", description="Total stored bytes across all the caller vaults. Present when ok is true.")
+    total_gb: float | None = Field(None, alias="totalGb", description="Total stored size in decimal GB (bytes / 1e9), rounded to 2 decimals. Present when ok is true.")
+    quota_bytes: Any | None = Field(None, alias="quotaBytes", description="Storage quota in bytes for the caller plan. Null when the plan is unlimited. Present when ok is true.")
+    quota_gb: Any | None = Field(None, alias="quotaGb", description="Storage quota in decimal GB, rounded to 2 decimals. Null when the plan is unlimited. Present when ok is true.")
+    unlimited: bool | None = Field(None, alias="unlimited", description="True when the caller plan is unlimited (no storage ceiling). Render \"Unlimited\" instead of a quota figure.")
+    per_vault: list[dict[str, Any]] | None = Field(None, alias="perVault", description="Per-vault storage breakdown for the caller vaults. Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_create.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableCreateInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Table name: lowercase letters, numbers, underscores, starting with a letter (e.g. rank_tracker).")
+    columns: list[dict[str, Any]] = Field(..., alias="columns", description="Columns to create, in addition to the automatic id/created_at/updated_at.")
+
+
+class TableCreateOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/validation error.")
+    table_name: str | None = Field(None, alias="tableName", description="The table name.")
+    created: bool | None = Field(None, alias="created", description="True if the table was newly created; false if it already existed.")
+    columns: list[dict[str, Any]] | None = Field(None, alias="columns", description="The columns requested (existing tables are not altered to match).")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_delete_rows.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableDeleteRowsInput(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]] = Field(..., alias="filters", description="Filters to AND together; rows matching all of them are deleted.")
+
+
+class TableDeleteRowsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/validation error.")
+    deleted: float | None = Field(None, alias="deleted", description="Number of rows deleted.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_describe.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableDescribeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Table name, from table-list.")
+
+
+class TableDescribeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth or not-found error.")
+    table_name: str | None = Field(None, alias="tableName", description="The table name.")
+    columns: list[dict[str, Any]] | None = Field(None, alias="columns", description="Column names and their Postgres types, in table order.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_drop.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableDropInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Table name to permanently delete, from table-list.")
+
+
+class TableDropOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope error.")
+    dropped: bool | None = Field(None, alias="dropped", description="True if the table existed and was dropped; false if it did not exist.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/table_insert_rows.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class TableInsertRowsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Table name, from table-list.")
+    rows: list[dict[str, Any]] = Field(..., alias="rows", description="Rows to insert, each an object of column name to value.")
+
+
+class TableInsertRowsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/validation error.")
+    inserted: float | None = Field(None, alias="inserted", description="Number of rows inserted.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")