docs(api-surfaces): document missing MCP tools (write, evolve, insights, tune) - #570
Open
Souptik96 wants to merge 1 commit into
Open
docs(api-surfaces): document missing MCP tools (write, evolve, insights, tune)#570Souptik96 wants to merge 1 commit into
Souptik96 wants to merge 1 commit into
Conversation
docs/api-surfaces.md named only 8 of the 12 registered MCP tools, so a reader inventorying the surface concluded there was no write, outcome-reporting, insights, or tuning tool. Add an 'MCP tool surface' table covering all 12 registered tools with their transport(s), minimum trust level, and a one-line contract, sourced from the ToolSpec SoT in core-api/src/core_api/tools/*.py and the handlers in core_api/mcp_server.py. Also name memclaw_write and memclaw_tune in the ownership table and add the previously-absent Karpathy Loop concerns (memclaw_evolve, memclaw_insights). Closes caura-ai#550
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/api-surfaces.mdwas out of sync with the MCP tool surface registered incore-api/src/core_api/mcp_server.py. The charter named only 8 of the 12registered MCP tools, so a reader inventorying the API surface from the doc
concluded there was no write, outcome-reporting, insights, or tuning tool —
while the server registers and serves all four.
This documents the four missing tools and gives the whole MCP surface a
first-class, per-tool reference.
Changes
## MCP tool surfacesection: a table of all 12 registeredMCP tools with
Transport(s),Trust required, and a one-lineContract,matching the issue's requested shape. Values are sourced from the
ToolSpecsingle-source-of-truth in
core-api/src/core_api/tools/*.pyand the handlersin
core_api/mcp_server.py.memclaw_write(bulk write) andmemclaw_tune(per-agent searchprofile) in the existing Surface ownership table.
Outcome reporting / weight reinforcement (
memclaw_evolve) andReflection / insights (
memclaw_insights).The four previously-undocumented tools
memclaw_writewritecapability)memclaw_evolveagent), ≥2 (fleet/all)memclaw_insightsagent), ≥2 (fleet/all)memclaw_tunewritecapability)Verification
mcp_server.pyand the
ToolSpecdeclarations (trust levels,plugin_exposed,op/scope-specific floors).
entities.py,agents.py,evolve.py,insights.py,stats.py,documents.py,keystones.py,memories.py).Closes #550