Skip to content

docs: fix dead ADK MCP tools source link after docs restructure - #9823

Merged
Vincent Biret (baywet) merged 1 commit into
microsoft:mainfrom
leom1919:docs-adk-mcp-source-link
Oct 29, 2026
Merged

Vincent Biret (baywet) merged 1 commit into
microsoft:mainfrom
leom1919:docs-adk-mcp-source-link

Conversation

@leom1919

Copy link
Copy Markdown
Contributor

Motivation

In docs/decisions/0002-agent-tools.md, the Google example's source link points to:

https://google.github.io/adk-docs/tools/mcp-tools/#using-mcp-tools-in-your-own-agent-out-of-adk-web

The ADK docs were restructured: the page now lives at tools-custom/mcp-tools/ (served via a JS redirect that forwards the fragment), and the section "Using MCP tools in your own agent (out of ADK Web)" no longer exists anywhere in google/adk-docs (verified via GitHub code search: 0 hits for the heading text; the SseServerParams tutorial content was removed, only API-reference pages remain). The anchor therefore lands on the top of the page instead of the intended section.

Changes

  • Update the source URL (href + display text, 1 line) to the current canonical page with the semantically matching section:
    https://google.github.io/adk-docs/tools-custom/mcp-tools/#direct-mcp-tool-integration-mcptoolset
    (heading "Direct MCP Tool integration (McpToolset)", verified present in the rendered page — the cited example is exactly an MCPToolset-based agent snippet).

Verification

  • Old URL: page 200 only via redirect shell; target anchor id using-mcp-tools-in-your-own-agent-out-of-adk-web confirmed absent from the live page's rendered heading ids.
  • New URL: page 200 (207 KB rendered page), id="direct-mcp-tool-integration-mcptoolset" confirmed present (<h3>Direct MCP Tool integration (McpToolset)).

AI Assistance

  • AI-assisted — this PR was authored by an automated agent (link checking + fix proposal); all replacement URLs and anchors were verified against the live ADK docs site and the google/adk-docs repository before submission.

Copilot AI 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.

🟢 Approval recommended

No active review issues are reported for the documentation-only Google ADK source-link update.

No open issues 🎉

What changed in this PR

Updates the Google ADK source link in the agent-tools decision record to reflect the documentation restructure. No executable code changes.

Changes:

  • Replaces the outdated URL and fragment with the canonical MCP tools page’s “Direct MCP Tool integration (McpToolset)” section.
  • Updates both the link target and displayed URL.
File Description
docs/​decisions/​0002-agent-tools.md Corrects the source link for the Google MCPToolset example.

Review effort: Balanced

This was referenced Nov 9, 2026

This branch was previously deployed

1 inactive deployment
github-app-auth — 4a9e928d Deployed Oct 29, 2026 by leom1919 via team_check #7963
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants