Skip to content

Promote the first-party docs MCP server in the agent docs - #1775

Merged
GreenFlux merged 3 commits into
developfrom
docs/first-party-mcp
Sep 18, 2026
Merged

GreenFlux merged 3 commits into
developfrom
docs/first-party-mcp

Conversation

@GreenFlux

@GreenFlux GreenFlux commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Summary

The first-party docs MCP server is live at https://docs-assistant.handsontable.com/mcp — semantic search over the full HyperFormula + Handsontable knowledge base (docs guides, API reference, code recipes, release notes, blog posts, and GitHub issues), always current with the latest release. This PR makes it the recommended MCP route in the agent-facing docs:

  • Set up your coding agent guide: the "Live docs via MCP" section now leads with the first-party server (GitMCP and Context7 stay as alternatives); added to the page tags and the Resources list.
  • Wizard: the Cursor path now hands out a .cursor/mcp.json config for the server (Cursor supports MCP natively; the rules-file corpus pointer stays as the noted alternative), and the Other/API path mentions the MCP URL.
  • README: one sentence pointing MCP-capable agents at the server.

The endpoint was verified live before this PR: initialize, tools/list, and a real tools/call all pass, serving the current knowledge-base pair (HT 18.1.0 / HF 3.4.0).

Test plan

  • Docs-only change: docs/guide/setup-coding-agent.md renders with the existing anchors unchanged (the #live-docs-via-mcp-any-agent sidebar link still resolves)
  • Wizard JSON snippet is valid .cursor/mcp.json content

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only updates to README, docs pages, and the coding-agent wizard; no runtime or library code changes.

Overview
This PR updates agent-facing documentation to recommend the first-party docs MCP server at https://docs-assistant.handsontable.com/mcp for live, semantic search over HyperFormula and Handsontable docs.

In Set up your coding agent, the “Live docs via MCP” section now leads with that server (GitMCP and Context7 remain alternatives), and the Resources list adds a link to the Docs MCP Server guide. The CodingAgentWizard Cursor path now copies a .cursor/mcp.json snippet for the server, with the llms-full.txt rules-file approach noted as a fallback; the Other/API option also mentions the MCP URL. README and docs index gain a short paragraph pointing MCP-capable agents at the same server.

Reviewed by Cursor Bugbot for commit b0a6520. Bugbot is set up for automated code reviews on this repo. Configure here.

Lead the Live docs via MCP section with the first-party server at
docs-assistant.handsontable.com/mcp, switch the wizard's Cursor path
to an MCP config, mention the server in the Other/API path and the
README, and add it to the page's tags and Resources list.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 17, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
hyperformula-docs b0a6520 Commit Preview URL

Branch Preview URL
Sep 18 2026, 10:59 AM

@github-actions

github-actions Bot commented Sep 17, 2026

Copy link
Copy Markdown

Performance comparison of head (b0a6520) vs base (c920375)

                                     testName |    base |   head | change
-------------------------------------------------------------------------
                                      Sheet A |  375.34 | 385.96 | +2.83%
                                      Sheet B |  112.27 | 113.91 | +1.46%
                                      Sheet T |  101.47 | 100.64 | -0.82%
                                Column ranges |  487.13 | 483.87 | -0.67%
                                Sorted lookup | 14759.6 |  15366 | +4.11%
Sheet A:  change value, add/remove row/column |     9.3 |   9.51 | +2.26%
 Sheet B: change value, add/remove row/column |   95.76 |  96.46 | +0.73%
                   Column ranges - add column |   123.4 | 122.53 | -0.71%
                Column ranges - without batch |  405.81 | 395.83 | -2.46%
                        Column ranges - batch |   99.93 |  93.79 | -6.14%

@GreenFlux
GreenFlux marked this pull request as ready for review September 17, 2026 14:53

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 8f2b299. Configure here.

Comment thread README.md Outdated
Comment thread docs/guide/setup-coding-agent.md Outdated
…extra tag

README.md and docs/index.md are hand-maintained mirrors, so the docs
homepage gets the same first-party MCP sentence. The MCP tag pushed
setup-coding-agent.md past the 10-tag maximum and the section heading
already carries the term for search, so it is removed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The guide shipped to the Handsontable docs, so human-facing prose
links point there instead of the raw endpoint (which answers 405 in
a browser); config snippets keep the literal endpoint URL.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@AMBudnik AMBudnik left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@codecov

codecov Bot commented Sep 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.32%. Comparing base (c920375) to head (b0a6520).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff            @@
##           develop    #1775   +/-   ##
========================================
  Coverage    97.32%   97.32%           
========================================
  Files          195      195           
  Lines        15739    15739           
  Branches      3390     3461   +71     
========================================
  Hits         15318    15318           
+ Misses         421      413    -8     
- Partials         0        8    +8     

see 5 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@GreenFlux
GreenFlux merged commit 5abbbd9 into develop Sep 18, 2026
34 checks passed
@GreenFlux
GreenFlux deleted the docs/first-party-mcp branch September 18, 2026 11:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants