MCP Tools

Register this AI session with Synchronex so it appears in the pane picker. Call this at the very start of every session. If you have a remote share URL (Claude Code: /share), pass it as session_url — Synchronex will offer it as a live pane in the terminal grid. Returns a session_id to use in subsequent calls.

Scope: write. Group: Sessions. Inputs: product_namesession_urlagent_namelabelmetadata.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "register_session",
    "arguments": {
      "product_name": "example"
    }
  }
}

Signal that this IDE session has ended. Synchronex will summarize decisions made during the session, update the Product State Document, and write a handoff note for the next session. Call this in your IDE teardown hook or at the end of each session. Returns decisions_captured and handoff_note for confirmation.

Scope: write. Group: Sessions. Inputs: session_idsummaryended_by.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "end_session",
    "arguments": {
      "session_id": "example"
    }
  }
}

Returns the user's Identity Kernel — identity, product portfolio, standing constraints, and model preferences. Inject the returned injection_block at the start of every session to restore persistent identity context.

Scope: read. Group: Memory & context. Inputs: session_idclient_type.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_identity_kernel",
    "arguments": {
      "session_id": "example"
    }
  }
}

Returns the current Product State Document for a specific product, including last session summary, handoff note, what works, blockers, and open questions.

Scope: read. Group: Memory & context. Inputs: product_name.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_product_state",
    "arguments": {
      "product_name": "example"
    }
  }
}

Semantic search over the cross-product decision history. Returns ranked, relevant decisions trimmed to a token budget. Falls back to keyword search if embeddings are unavailable.

Scope: read. Group: Memory & context. Inputs: queryproduct_namelimittoken_budget.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "search_decisions",
    "arguments": {
      "query": "example"
    }
  }
}

Returns the handoff note (next_session_starts_here) for a product. Use this at the very start of a session to orient before loading full state. The lightest memory call available.

Scope: read. Group: Memory & context. Inputs: product_name.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_session_handoff",
    "arguments": {
      "product_name": "example"
    }
  }
}

Audits a session context block for stale data, constraint violations, and overall confidence score. Paste your CLAUDE.md or any injected memory block to validate it before relying on it.

Scope: read. Group: Memory & context. Inputs: context.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "check_memory_confidence",
    "arguments": {
      "context": "example"
    }
  }
}

Writes a new architectural or product decision to the cross-product decision index. Auto-tags, generates an embedding, and calculates temporal weight. Use this when a significant decision is made during a session.

Scope: write. Group: Memory & context. Inputs: decisionreasoningproduct_nameaffects_productsworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "log_decision",
    "arguments": {
      "decision": "example"
    }
  }
}

Record a project signal or event into the Synchronex command center. Use for deployments, errors, decisions, and any notable state change.

Scope: write. Group: Memory & context. Inputs: project_idevent_typetitleseveritybodyoccurred_at.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "log_project_event",
    "arguments": {
      "project_id": "example"
    }
  }
}

Send a team message or direct message to a teammate. Use this when the user explicitly asks you to message someone on their team.

Scope: write. Group: Workers. Inputs: tobodyentity_referenceworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "send_message",
    "arguments": {
      "to": "example"
    }
  }
}

Exports the authenticated user's active kernel into client-specific formats or a registered scaffold template.

Scope: read. Group: Memory & context. Inputs: formattemplate_idproduct_namebudgetsession_idclient_type.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "export_kernel",
    "arguments": {
      "format": "example"
    }
  }
}

Confirms that the AI agent loaded the Synchronex Identity Kernel for this session. Call once after reading the exported kernel or receiving kernel context.

Scope: read. Group: Memory & context. Inputs: session_idsentinel_tokenkernel_fingerprint.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_kernel_attest",
    "arguments": {
      "session_id": "example"
    }
  }
}

Updates the Product State Document for a specific product. Accepts partial updates — only provided fields are changed. Creates the state document if it doesn't exist yet.

Scope: write. Group: Memory & context. Inputs: product_namelast_session_summarynext_session_starts_herestatuswhat_workswhat_is_blockedopen_questions.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "update_product_state",
    "arguments": {
      "product_name": "example"
    }
  }
}

Queue brand-aware content generation. Video requests use the async studio job pattern; poll with studio_get_job.

Scope: write. Group: Studio / generation. Inputs: content_typebriefformatworkspace_idbrand_idprovidermetadata.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "studio_generate",
    "arguments": {
      "content_type": "example"
    }
  }
}

Queue a brand-aware content lane plan from a brief.

Scope: write. Group: Studio / generation. Inputs: briefduration_weeksworkspace_idbrand_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "studio_plan",
    "arguments": {
      "brief": "example"
    }
  }
}

Queue content variants for approval from an existing generation request.

Scope: write. Group: Studio / generation. Inputs: generation_request_idvariant_count.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "studio_propose",
    "arguments": {
      "generation_request_id": "example"
    }
  }
}

Poll a studio generation job or async media job.

Scope: read. Group: Studio / generation. Inputs: job_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "studio_get_job",
    "arguments": {
      "job_id": "example"
    }
  }
}

List active Synchronex workers and recent run state.

Scope: read. Group: Workers. Inputs: statusworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "worker_list",
    "arguments": {
      "status": "example"
    }
  }
}

Trigger an active worker run. Returns immediately with a run id; poll with worker_get_run.

Scope: write. Group: Workers. Inputs: worker_typetaskworkspace_idbrand_idinput.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "worker_run",
    "arguments": {
      "worker_type": "example"
    }
  }
}

Read the status and output of a worker run.

Scope: read. Group: Workers. Inputs: run_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "worker_get_run",
    "arguments": {
      "run_id": "example"
    }
  }
}

Approve an escalated worker run and resume execution. Requires full-scope MCP credentials.

Scope: full. Group: Workers. Inputs: run_iddecision_reasonedited_action.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "worker_approve",
    "arguments": {
      "run_id": "example"
    }
  }
}

Read the authenticated user Identity Kernel.

Scope: read. Group: Kernel management. Inputs: none.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "kernel_get",
    "arguments": {}
  }
}

Merge a validated partial update into one Identity Kernel slice.

Scope: write. Group: Kernel management. Inputs: slice_nameupdates.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "kernel_update_slice",
    "arguments": {
      "slice_name": "example"
    }
  }
}

List products managed by the authenticated user.

Scope: read. Group: Kernel management. Inputs: none.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "kernel_list_products",
    "arguments": {}
  }
}

List pending CEO proposals and escalated worker runs awaiting review.

Scope: read. Group: CEO / decisions. Inputs: limit.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "ceo_brief",
    "arguments": {
      "limit": "example"
    }
  }
}

Approve a CEO proposal or escalated worker run. Requires full-scope MCP credentials.

Scope: full. Group: CEO / decisions. Inputs: proposal_idrun_idnotes.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "ceo_approve",
    "arguments": {
      "proposal_id": "example"
    }
  }
}

Reject a CEO proposal or escalated worker run with feedback. Requires full-scope MCP credentials.

Scope: full. Group: CEO / decisions. Inputs: proposal_idrun_idfeedback.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "ceo_reject",
    "arguments": {
      "proposal_id": "example"
    }
  }
}

Lists normalized business datasets available to the authenticated user.

Scope: read. Group: Data ingress. Inputs: workspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "list_datasets",
    "arguments": {
      "workspace_id": "example"
    }
  }
}

Queries rows from a normalized business dataset by exact-match filters.

Scope: read. Group: Data ingress. Inputs: namelimitfiltersworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "query_dataset",
    "arguments": {
      "name": "example"
    }
  }
}

Read a UTF-8 file from a GitHub-backed registered project. Use before proposing code edits.

Scope: read. Group: Developer tools. Inputs: project_idpathref.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "codebase_read_file",
    "arguments": {
      "project_id": "example"
    }
  }
}

Create or update one UTF-8 file in a GitHub-backed registered project. Requires full MCP scope.

Scope: full. Group: Developer tools. Inputs: project_idpathcontentbranchmessagesha.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "codebase_write_file",
    "arguments": {
      "project_id": "example"
    }
  }
}

Apply a prepared file-set diff to a GitHub-backed registered project by writing complete file contents. Requires full MCP scope.

Scope: full. Group: Developer tools. Inputs: project_idbranchmessagefiles.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "codebase_apply_diff",
    "arguments": {
      "project_id": "example"
    }
  }
}

Open a GitHub pull request for a registered project and track it in Synchronex. Requires full MCP scope.

Scope: full. Group: Developer tools. Inputs: project_idtitleheadbasebodydraftproduct_idworker_run_idworkstream_brief_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "codebase_open_pull_request",
    "arguments": {
      "project_id": "example"
    }
  }
}

List Synchronex-tracked pull requests for a GitHub-backed registered project.

Scope: read. Group: Developer tools. Inputs: project_idstatelimit.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "codebase_list_pull_requests",
    "arguments": {
      "project_id": "example"
    }
  }
}

Returns the authenticated user Identity Kernel as structured JSON.

Scope: read. Group: Memory & context. Inputs: none.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_kernel_read",
    "arguments": {}
  }
}

Merges a partial update into the authenticated user Identity Kernel.

Scope: write. Group: Memory & context. Inputs: updates.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_kernel_update",
    "arguments": {
      "updates": "example"
    }
  }
}

Searches memory layers (kernel, product state, decisions, free-form memories); decisions and free-form memories use semantic pgvector search.

Scope: read. Group: Memory & context. Inputs: querylimitlayer.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_search",
    "arguments": {
      "query": "example"
    }
  }
}

Returns the current state document for a product by name.

Scope: read. Group: Memory & context. Inputs: product.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_product_state_read",
    "arguments": {
      "product": "example"
    }
  }
}

Applies partial updates to a product state document.

Scope: write. Group: Memory & context. Inputs: productupdates.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_product_state_write",
    "arguments": {
      "product": "example"
    }
  }
}

Appends a cross-product decision to the decision index.

Scope: write. Group: Memory & context. Inputs: decisioncontextproducts_affected.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_decision_log",
    "arguments": {
      "decision": "example"
    }
  }
}

Stores a cross-AI session summary with attribution.

Scope: write. Group: Memory & context. Inputs: summarytopicsai_tool.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "memory_session_summary",
    "arguments": {
      "summary": "example"
    }
  }
}

Stores a free-form note in cloud memory with optional tags and workspace scope.

Scope: write. Group: Memory & context. Inputs: titlecontenttagsworkspace_idis_pinned.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "remember_free_form",
    "arguments": {
      "title": "example"
    }
  }
}

Searches free-form cloud memories by semantic or keyword match.

Scope: read. Group: Memory & context. Inputs: querylimitworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "recall_free_form",
    "arguments": {
      "query": "example"
    }
  }
}

Lists registered Synchronex workspace sync targets for the authenticated user.

Scope: read. Group: Workspaces. Inputs: none.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "list_registered_workspaces",
    "arguments": {}
  }
}

Lists workspace drift events for the authenticated user.

Scope: read. Group: Workspaces. Inputs: status.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_drift_events",
    "arguments": {
      "status": "example"
    }
  }
}

Accepts or rejects a pending workspace drift event.

Scope: write. Group: Workspaces. Inputs: actionnoteresolved_bydrift_event_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "approve_inbound_change",
    "arguments": {
      "action": "example"
    }
  }
}

Renders the current kernel export for a registered workspace. The MCP client writes the returned file content locally.

Scope: write. Group: Workspaces. Inputs: workspace_registration_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "sync_workspace_state",
    "arguments": {
      "workspace_registration_id": "example"
    }
  }
}

Submit an inbound command through the intake spine. The command is recorded to the immutable command ledger and queued as a PENDING proposal for human approval; nothing executes directly.

Scope: write. Group: Command intake. Inputs: raw_contentrequested_capability.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "intake_command",
    "arguments": {
      "raw_content": "example"
    }
  }
}

Lists inbound command proposals for the authenticated user.

Scope: read. Group: Command intake. Inputs: status.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "get_inbound_commands",
    "arguments": {
      "status": "example"
    }
  }
}

Accepts or rejects a pending inbound command proposal. Approval is a recorded decision only; execution is separately gated. Requires full-scope MCP credentials.

Scope: full. Group: Command intake. Inputs: proposal_idactionnote.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "approve_inbound_command",
    "arguments": {
      "proposal_id": "example"
    }
  }
}

Search Gmail threads in one explicitly labeled connected account.

Scope: read. Group: Gmail. Inputs: account_labelqlimitworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "gmail_search",
    "arguments": {
      "account_label": "example"
    }
  }
}

Read a full Gmail thread from one explicitly labeled connected account.

Scope: read. Group: Gmail. Inputs: account_labelthread_idworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "gmail_read",
    "arguments": {
      "account_label": "example"
    }
  }
}

Propose a new Gmail message from one explicitly labeled account. The message is not sent until a human approves the connector write decision.

Scope: write. Group: Gmail. Inputs: account_labeltosubjectbodyworkspace_id.

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "gmail_send",
    "arguments": {
      "account_label": "example"
    }
  }
}