Repository navigation
v1.3.0 — self-documenting MCP
The MCP now carries its own documentation. The external google-docs-fly_MCP_Reference.md becomes redundant by design.
What changed
Connect-time orientation. _SERVER_INSTRUCTIONS now includes:
- One sentence on what the server does
- 5 named workflows (goal → tool sequence):
new_doc,convert_doc_with_headings,retrofit_styled_doc,convert_sandbox_docx,cleanup - 5 operating rules (never rebuild styled .docx;
docx_pathdoesn't work from cloud chat;placeholder_behavior="rename"preserves a title page; trash tools only act on own files; first use needs interactive OAuth consent) - Pointer to
gdocs_guide/gdocs_server_info
New gdocs_guide tool. Zero-arg, always callable. Returns the same orientation as a structured payload:
{server, workflows[], operating_rules[], tool_groups{}}
Rationale: server instructions is seen only at connect time and some clients truncate or ignore it. gdocs_guide is the "start here" / --help entry point.
Workflow-aware tool descriptions. Every tool description ends with a Choreography: line (what typically comes before / after) and a NOTE: block for known failure modes — so an agent doesn't have to discover them by hitting errors:
gdocs_preview_tab_split/gdocs_tab_existing_doc/gdocs_get_signed_upload_url—docx_pathdoesn't work from cloud chatgdocs_trash_file/gdocs_untrash_file/gdocs_move_to_folder— only works on files this app createdgdocs_setup_apps_script— first call returnsneeds_authorizationwith a URL the user must open
Tests
EXPECTED_TOOLSaddsgdocs_guide(22 total);no_arg_toolsextended.- New
test_gdocs_guide_shape_includes_all_5_workflows_and_rulesasserts the 5 named workflows, 5 operating-rule topics, 7 tool_group buckets. - 240/240 unit pass; 8/8 mutations caught cleanly.
Acceptance
A fresh agent with only (a) the server instructions and (b) the tool list — no external reference file — can correctly choose and sequence tools for all 5 core workflows and avoid the known failure modes without first triggering them. gdocs_guide is the callable fallback.