MCP tools

Every tool below is callable by any MCP client connected to https://innernet.live/api/mcp (JSON-RPC 2.0, Authorization: Bearer <token>). Most users never call them directly — the AI client wraps them.

context maps#

tool	what it does
`innernet_list_projects`	List your context maps — slug, name, type, tagline, last update.
`innernet_load_project`	Load a full map: dimensions, nodes, recent commits, capture protocol, and a disclosure-gated slice of your Self Map.
`innernet_save_context`	Create/update a project. Upserts dimensions and nodes by name — merge, never wipe.
`innernet_get_dimension`	Read one dimension's markdown without loading the whole map.
`innernet_get_capture_protocol`	Read the per-project capture instructions.
`innernet_set_capture_protocol`	Replace the capture protocol (owner only).

branches — versioned, forkable context#

tool	what it does
`innernet_list_branches`	A project's branches with status and fork-from commits.
`innernet_branch_new`	Fork the map at its head — the branch gets a full overlay snapshot of dimensions + nodes.
`innernet_branch_diff`	Added / modified / removed / unchanged, branch vs trunk.
`innernet_branch_park`	Archive without merging (overlay preserved); `park: false` revives.
`innernet_branch_merge`	Fold the branch into trunk (branch wins), record a merge commit, bump the head.

capture & search#

tool	what it does
`innernet_capture`	Capture a note/decision/insight. Without `project_slug` the Concierge auto-routes it (project, Personal Memory, both, or discard) — and the raw content is persisted before any routing, so a routing failure can never lose it.
`search`	Ranked full-text search across dimensions, nodes, captures, projects, and memories. (Also drives ChatGPT Deep Research.)
`fetch`	A project's full content as one markdown blob (ChatGPT Deep Research).

personal memory — the Self Map#

tool	what it does
`innernet_self_capture`	Save a fact-candidate about you to the cloud Self queue.
`innernet_self_status`	Counts: facts, pending candidates, open questions, by dimension/disclosure.
`innernet_self_facts`	Read facts up to a disclosure ceiling (`private` never crosses MCP).
`innernet_self_sync`	Run the consolidator over pending candidates now.
`innernet_triage`	Ask the Concierge where a piece of content belongs without committing (or commit with `commit: true`).

tasks#

tool	what it does
`innernet_task_list`	The project's ordered task board.
`innernet_task_create`	Add a task.
`innernet_task_update`	Update fields/status.
`innernet_task_complete`	Mark done.
`innernet_task_reorder`	Reorder the board.

artifacts — live documents#

tool	what it does
`innernet_artifact_start`	Open a living document for a research/build session.
`innernet_artifact_append`	Land a raw fragment (fast). The fold into the document runs server-side after the response.
`innernet_artifact_status`	Active artifact + pending fragment count.
`innernet_artifact_read`	Read the current document.
`innernet_artifact_list`	All artifacts in a project.
`innernet_artifact_stop`	Final fold, then mark done.

ambient#

tool	what it does
`innernet_ambient`	The off-switch (and tuning surface) for ambient behaviour — session recognition, auto-artifacts, task nudges.

protocol#

Revisions 2025-06-18 / 2025-03-26 / 2024-11-05, negotiated on initialize.
Resources: innernet://project/{slug}/map (JSON) and innernet://project/{slug}/dimension/{name} (markdown), listed via resources/list.
JSON-RPC batch requests accepted. Rate limit 240 calls/min/account.
Prefer the REST API for scripted access — that's what it's for. MCP is for AI clients.