MCP tools for agents
Use the advertised operation catalog and call the exact authorized tool for the job.
Prism is the system of record. An MCP-compatible client should orient, retrieve exact evidence, make reviewable changes only when authorized, and leave irreversible or human-judgment decisions in Prism.
Workflow
Primary steps
- 1Call get_prism_workspace_context, then verify_prism_host_capabilities if the host may have a stale tool snapshot.
- 2Use get_prism_task_context or get_agent_context_pack to understand the task, Project, and evidence before selecting actions.
- 3Call the relevant tool directly using its advertised schema, scope, and annotations.
- 4Preview consequential changes, commit only the approved operation, and report the real outcome and cited evidence back to Prism.
Each operation exposed upfront
Every authorized source, writing, monitor, model, and research operation is exposed upfront as a separate MCP tool with its own description, input schema, and annotations.
Use get_prism_workspace_context to orient and verify_prism_host_capabilities to detect a stale host snapshot. Refresh the connection when authorized tools are missing.
Call an explicit operation
Select the relevant tool from tools/list. Each operation includes its exact input schema and read-only, destructive, and open-world annotations. Use writes only when the user requests a durable change.
Call the selected tool with its fields directly. Research writes use a preview-then-commit protocol: mode preview and a stable idempotencyKey return an operationId and commitToken; mode commit accepts those unchanged without replacement fields. Use apply_research_bundle only for already-previewed operations, and undo_prism_operation only when Prism reports safe compensation and the user confirms it.
A server-authorized action may still be unavailable in a host with a frozen action snapshot. verify_prism_host_capabilities distinguishes actions currently callable by the host from actions Prism authorizes but the host needs to refresh.
Non-negotiable boundaries
MCP does not publish or schedule posts, send email, submit external forms, click confirmation links, execute brokerage trades, connect brokerage accounts, or apply the canonical thesis. Agents may prepare private drafts, Project content, source-backed proposals, and reviewable tracking updates within their scopes.
Use source chunks and their location metadata as evidence. Context packs, observations, models, workspace memory, and a successful tool call can inform reasoning, but they are not proof by themselves. If retrieval is incomplete or evidenceSufficient is false, say so rather than filling the gap from memory.
Granular action catalog
Every action, grouped by the work it does
Agents discover only the authorized actions for their current connection. This reference names the full Prism registry so builders can recognize each workflow.
Orient, discover, and control work
27 toolsMap the authorized workspace, verify what the host can actually call, resolve references, compile task context, and safely apply or undo logged work.
Projects, sources, and inputs
57 toolsCreate and organize Project material, classify sources, inspect retrieval health, and manage supported web, file, RSS, YouTube, and Site Monitor inputs.
Source retrieval and exact evidence
11 toolsSearch authorized knowledge, read bounded sources or stable chunks, and update only the Project material the user explicitly authorized.
Company research and review
18 toolsRead thesis and claim context, identify evidence gaps, generate a Project recap, run safe model scenarios, and create review-only thesis proposals or Research Deltas.
Research Threads and durable tasks
22 toolsMaintain reviewable hypothesis case files, launch bounded Prism research work, and resume durable campaigns or tasks without treating completion as human approval.
Writing Studio
7 toolsRead, create, revise, cite, and add visuals to private writing. Draft and published-work revisions use explicit reviewable flows; MCP never publishes or schedules a post.
Visual artifacts
14 toolsPlan, prepare, validate, save, retrieve, and place structured charts, tables, metric cards, Markdown, HTML, and React artifacts.
Knowledge graph
8 toolsInspect evidence connections and create, revise, archive, delete, or clean explicit Project relationships under the graph scope.
Project Canvas
4 toolsRead, create, and update Project Canvases while preserving authored layout and using the latest version for changes.
Watchlists, monitors, and briefings
17 toolsTrack Market tickers and structured Project conditions, record source-backed updates, and operate reviewable Project monitors and briefings.
Research calendar
5 toolsRead, create, revise, and, with explicit confirmation, delete personal or Project events with dates, sources, and outcome history.
Prism Email
14 toolsRead authorized inboxes, organize messages and labels, manage sender rules, create allowed addresses, and save selected received material into a Project. Email remains inbound-only through MCP.
Workspace memory
11 toolsInspect explainable workspace memory, then explicitly remember, correct, or forget a stable memory record without changing source material.
Portfolio and decision journal
12 toolsRead or update Prism's own tracking records and decision journal. These tools never connect to a brokerage or execute a trade.
Published work
2 toolsList published posts and inspect their evidence health. Revisions become private drafts for a person to review and republish in Prism.
Writing operations
11 toolsCall each operation directly with its advertised schema and authorized scope.
Citations operations
5 toolsCall each operation directly with its advertised schema and authorized scope.
Monitoring operations
11 toolsCall each operation directly with its advertised schema and authorized scope.
Observations operations
3 toolsCall each operation directly with its advertised schema and authorized scope.
Research deltas operations
6 toolsCall each operation directly with its advertised schema and authorized scope.
Imports operations
4 toolsCall each operation directly with its advertised schema and authorized scope.
Writing style operations
7 toolsCall each operation directly with its advertised schema and authorized scope.
Models operations
9 toolsCall each operation directly with its advertised schema and authorized scope.
Entities operations
10 toolsCall each operation directly with its advertised schema and authorized scope.
Artifacts operations
6 toolsCall each operation directly with its advertised schema and authorized scope.