Skip to content

v1.3.0 — self-documenting MCP

Choose a tag to compare

@Sundeepg98 Sundeepg98 released this 19 May 04:44
· 245 commits to main since this release

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_path doesn'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_path doesn't work from cloud chat
  • gdocs_trash_file / gdocs_untrash_file / gdocs_move_to_folder — only works on files this app created
  • gdocs_setup_apps_script — first call returns needs_authorization with a URL the user must open

Tests

  • EXPECTED_TOOLS adds gdocs_guide (22 total); no_arg_tools extended.
  • New test_gdocs_guide_shape_includes_all_5_workflows_and_rules asserts 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.