Skip to content

docs: add Oruk remote MCP integration - #2209

Open
Nathan-Roll1 wants to merge 2 commits into
google:mainfrom
Nathan-Roll1:codex/oruk-mcp-adk-2026-09-07
Open

docs: add Oruk remote MCP integration#2209
Nathan-Roll1 wants to merge 2 commits into
google:mainfrom
Nathan-Roll1:codex/oruk-mcp-adk-2026-09-07

Conversation

@Nathan-Roll1

Copy link
Copy Markdown

Adds a Python integration page for Oruk's hosted Streamable HTTP MCP server, with a copyable ADK agent, environment-based bearer authentication, and a filter exposing only speech tools and model discovery. I maintain the Oruk integration.

The page documents prerecorded English audio, public-URL/base64 inputs, compact/full response limits, and tool-level errors. It also explains that vocal-expression scores do not establish private feelings, intent, identity, or a diagnosis. The two-file change follows the integration catalog conventions and adds no navigation entry or dependency to this repository.

Validation:

  • Tested the exact Python code block with google-adk[mcp]==2.8.0 and MCP 1.30.0 on Python 3.12.13.
  • Six offline tests passed: missing/blank credentials, agent construction, header authentication and exact argument forwarding through a local Streamable HTTP fixture, four-tool filtering, tool errors on successful HTTP responses, and connection cleanup/recreation. Fixture outputs are synthetic and are not quality results.
  • Live MCP initialization and tool discovery passed. An unauthenticated audio call returned the expected tool error. One temporary no-account trial then completed one tone-analysis call for the linked 4.054-second public sample using oruk-resonance and detail: full; no transcript was requested. The returned task/model/duration and structured scores were validated. No API key is included in this PR.
  • mkdocs serve built successfully; the page, catalog entry, icon, and linked external resources resolve. git diff --check passed.

The live check exercised ADK's MCP toolset directly. It did not invoke Gemini or evaluate the quality of an LLM-generated explanation.

@netlify

netlify Bot commented Sep 8, 2026

Copy link
Copy Markdown

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit af8f6aa
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/6a9f5eba5231ee00086297b9
😎 Deploy Preview https://deploy-preview-2209--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@google-cla

google-cla Bot commented Sep 8, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants