Skip to content

feat(mcp-docs): wire docs tools into umbrella server (ZEL-7844)#259

Open
dsklyar wants to merge 11 commits into
danielsklyar/zel-7843-mcp-docs-package-glue-and-clifrom
danielsklyar/zel-7844-mcp-docs-umbrella-wiring
Open

feat(mcp-docs): wire docs tools into umbrella server (ZEL-7844)#259
dsklyar wants to merge 11 commits into
danielsklyar/zel-7843-mcp-docs-package-glue-and-clifrom
danielsklyar/zel-7844-mcp-docs-umbrella-wiring

Conversation

@dsklyar

@dsklyar dsklyar commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Registers getDocsTools in the unified @transcend-io/mcp registry and merges DOCS_OAUTH_SCOPES.
  • Updates umbrella tool count 71 → 73 and extends registry/annotation/oauth-scope tests.
  • Adds package README, MCP root README table row, and changeset for publish.

Related Issues

Stack

PR 4 of 4 for ZEL-7840. Stacks on #258 (ZEL-7843). Merge stack bottom-up (#256#257#258 → this PR).

Test plan

  • pnpm run --dir packages/mcp/mcp-server-docs test
  • Umbrella registry count = 73
  • Pre-commit + pre-push hooks pass

Demo

Claude using docs list + fetch

Screen.Recording.2026-07-02.at.14.42.09.mov

Cursor demo of caching docs

Screen.Recording.2026-07-02.at.15.12.38.mov

Add @transcend-io/mcp-server-docs with llms.txt parsing, lru-cache-backed
getIndex/getBody helpers, and unit tests. Adds lru-cache to the pnpm catalog.
@linear-code

linear-code Bot commented Jul 2, 2026

Copy link
Copy Markdown

ZEL-7844

@pkg-pr-new

pkg-pr-new Bot commented Jul 2, 2026

Copy link
Copy Markdown

Open in StackBlitz

@transcend-io/airgap.js-types

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/airgap.js-types@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/airgap.js-types@259.tgz

@transcend-io/cli

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@259.tgz

@transcend-io/internationalization

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/internationalization@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/internationalization@259.tgz

@transcend-io/privacy-types

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@259.tgz

@transcend-io/sdk

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@259.tgz

@transcend-io/type-utils

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/type-utils@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/type-utils@259.tgz

@transcend-io/utils

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@259.tgz

@transcend-io/mcp

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp@259.tgz

@transcend-io/mcp-server-admin

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@259.tgz

@transcend-io/mcp-server-assessment

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessment@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessment@259.tgz

@transcend-io/mcp-server-base

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-base@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-base@259.tgz

@transcend-io/mcp-server-consent

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@259.tgz

@transcend-io/mcp-server-discovery

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@259.tgz

@transcend-io/mcp-server-docs

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-docs@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-docs@259.tgz

@transcend-io/mcp-server-dsr

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@259.tgz

@transcend-io/mcp-server-inventory

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@259.tgz

@transcend-io/mcp-server-preferences

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@259.tgz

@transcend-io/mcp-server-workflows

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@259
yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@259.tgz

commit: ec75374

@dsklyar dsklyar marked this pull request as ready for review July 2, 2026 21:49
@dsklyar dsklyar self-assigned this Jul 2, 2026
@dsklyar dsklyar force-pushed the danielsklyar/zel-7844-mcp-docs-umbrella-wiring branch 2 times, most recently from c9ac6c3 to 4f0e9e3 Compare July 2, 2026 21:53
dsklyar added 6 commits July 2, 2026 15:02
Drop DOCS_INDEX_TTL_MS env override and cache llms.txt index for one day.
…-7842)

Implement list+fetch documentation tools with section/keyword filters,
SSRF host guard, Source footer, and long-page truncation.
Wire getDocsTools, empty DOCS_OAUTH_SCOPES, and consent-style createMCPServer
cli entry with transcend-mcp-docs binary.
Use the published package version in createMCPServer instead of a hardcoded 1.0.0.
@dsklyar dsklyar force-pushed the danielsklyar/zel-7843-mcp-docs-package-glue-and-cli branch from 91d618c to 710a911 Compare July 2, 2026 22:03
dsklyar added 3 commits July 2, 2026 15:04
Register getDocsTools in the unified MCP registry, merge DOCS_OAUTH_SCOPES,
update tool count to 73, add README/changeset, and extend umbrella tests.
Index cache TTL is now a fixed 24h constant with no env override.
@dsklyar dsklyar force-pushed the danielsklyar/zel-7844-mcp-docs-umbrella-wiring branch from 4f0e9e3 to ec75374 Compare July 2, 2026 22:04
* Update this constant when tools are added or removed from any domain package.
*/
export const EXPECTED_UMBRELLA_TOOL_COUNT = 71;
export const EXPECTED_UMBRELLA_TOOL_COUNT = 73;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Why are 2 added instead of 1?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

There are two tools, one to list tools and one to fetch the url

@giacaglia giacaglia left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Nice!

@dsklyar dsklyar force-pushed the danielsklyar/zel-7843-mcp-docs-package-glue-and-cli branch from 710a911 to 67b6231 Compare July 2, 2026 23:41
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