🔴 Required Information
Describe the Bug:
The "Related samples" section of the agent_to_mcp guide links to a sample directory that does not exist. The link is dead in the rendered docs.
docs/guides/tools/mcp_tool/agent_to_mcp/index.md:139:
* [MCP: serve an ADK agent](../../../../../contributing/samples/mcp/mcp_serve_agent)
There is no mcp_serve_agent under contributing/samples/mcp/, and no directory of that name anywhere in the repository.
Steps to Reproduce:
- Open
docs/guides/tools/mcp_tool/agent_to_mcp/index.md on main.
- Scroll to the "Related samples" section at the bottom.
- Click the "MCP: serve an ADK agent" link — it 404s.
Or from a clone:
ls contributing/samples/mcp/mcp_serve_agent # No such file or directory
find . -name "*mcp_serve*" -not -path "./.git/*" # no match
Expected Behavior:
The link resolves to the sample that demonstrates serving an ADK agent over MCP.
Observed Behavior:
The link target does not exist, so it 404s on GitHub.
Environment Details:
- ADK Library Version: N/A — documentation issue, reproduced on
main at 4cee97f
- Desktop OS: macOS
- Python Version: N/A
Model Information:
- Are you using LiteLLM: N/A
- Which model is being used: N/A
🟡 Optional Information
Additional Context:
The 14 directories that do exist under contributing/samples/mcp/ are:
mcp_dynamic_header_agent mcp_sse_agent
mcp_in_agent_tool_remote mcp_sse_mtls_agent
mcp_in_agent_tool_stdio mcp_stdio_notion_agent
mcp_postgres_agent mcp_stdio_server_agent
mcp_progress_callback_agent mcp_streamablehttp_agent
mcp_server_side_sampling mcp_toolset_auth
mcp_service_account_agent tool_mcp_stdio_notion_config
Going by name, mcp_stdio_server_agent and mcp_server_side_sampling look like the closest candidates, but I did not want to guess and point the docs at the wrong sample.
I found this while fixing four other broken relative links in #6489, and deliberately left this one out of that PR because it needs a maintainer decision rather than a mechanical fix. Happy to send the one-line patch as soon as someone confirms which sample this should point to (or whether the sample was removed and the bullet should just be dropped).
How often has this issue occurred?:
🔴 Required Information
Describe the Bug:
The "Related samples" section of the
agent_to_mcpguide links to a sample directory that does not exist. The link is dead in the rendered docs.docs/guides/tools/mcp_tool/agent_to_mcp/index.md:139:There is no
mcp_serve_agentundercontributing/samples/mcp/, and no directory of that name anywhere in the repository.Steps to Reproduce:
docs/guides/tools/mcp_tool/agent_to_mcp/index.mdonmain.Or from a clone:
Expected Behavior:
The link resolves to the sample that demonstrates serving an ADK agent over MCP.
Observed Behavior:
The link target does not exist, so it 404s on GitHub.
Environment Details:
mainat4cee97fModel Information:
🟡 Optional Information
Additional Context:
The 14 directories that do exist under
contributing/samples/mcp/are:Going by name,
mcp_stdio_server_agentandmcp_server_side_samplinglook like the closest candidates, but I did not want to guess and point the docs at the wrong sample.I found this while fixing four other broken relative links in #6489, and deliberately left this one out of that PR because it needs a maintainer decision rather than a mechanical fix. Happy to send the one-line patch as soon as someone confirms which sample this should point to (or whether the sample was removed and the bullet should just be dropped).
How often has this issue occurred?: