[Docs] Update MCP tool filtering to use comma-separated list

[joaquim-verges]

---

PR-Codex overview

This PR updates the documentation and code to clarify how to filter available tools for the MCP server by using a comma-separated list of tools instead of multiple tool query parameters.

Detailed summary

• Updated text in page.mdx files to specify using a comma-separated list of tools for filtering.
• Changed example URLs in apps/portal/src/app/ai/mcp/page.mdx and apps/portal/src/app/payments/x402/agents/page.mdx to reflect the new query parameter format.
• Updated url in the mcpServers object and MultiServerMCPClient to use tools instead of tool.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

Summary by CodeRabbit

• Documentation
  • Updated guidance to use a single tools query parameter with comma-separated values for filtering tools, replacing repeated tool parameters.
  • Refreshed example URLs and code snippets (TypeScript and Python) to reflect the new tools syntax.
  • Applied changes across AI/MCP and Payments x402 Agents documentation pages.
  • Clarified parameter naming and formatting without altering underlying behavior or logic.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 7fcba52

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs-v2	Ready	Preview	Comment	Oct 6, 2025 11:18am

4 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
nebula	Skipped			Oct 6, 2025 11:18am
thirdweb_playground	Skipped			Oct 6, 2025 11:18am
thirdweb-www	Skipped			Oct 6, 2025 11:18am
wallet-ui	Skipped			Oct 6, 2025 11:18am

[joaquim-verges]

• [Docs] Update MCP tool filtering to use comma-separated list #8189 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• merge-queue - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Documentation updates adjust MCP tool filtering examples from repeated query parameters (tool=...) to a single comma-separated tools parameter (tools=...). Changes are limited to MDX content and example snippets in two pages; no code, logic, or control-flow modifications.

Changes

Cohort / File(s)	Summary of changes
Docs: MCP tools query param update apps/portal/src/app/ai/mcp/page.mdx, apps/portal/src/app/payments/x402/agents/page.mdx	Replaced repeated query parameter usage (multiple tool=...) with a single tools= comma-separated list in text and examples (TypeScript, Python, and URLs). No functional or API behavior changes; documentation-only edits.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch _Docs_Update_MCP_tool_filtering_to_use_comma-separated_list

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 5a26217 and 7fcba52.

📒 Files selected for processing (2)

• apps/portal/src/app/ai/mcp/page.mdx (1 hunks)
• apps/portal/src/app/payments/x402/agents/page.mdx (3 hunks)

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 55.03%. Comparing base (5a26217) to head (7fcba52).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #8189   +/-   ##
=======================================
  Coverage   55.03%   55.03%           
=======================================
  Files         919      919           
  Lines       60562    60562           
  Branches     4122     4122           
=======================================
  Hits        33332    33332           
  Misses      27126    27126           
  Partials      104      104           

Flag	Coverage Δ
packages	55.03% <ø> (ø)

🚀 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.

[github-actions]

size-limit report 📦

Path	Size	Loading time (3g)	Running time (snapdragon)	Total time
thirdweb (esm)	64.6 KB (0%)	1.3 s (0%)	389 ms (+222.86% 🔺)	1.7 s
thirdweb (cjs)	365.75 KB (0%)	7.4 s (0%)	1.3 s (+23.01% 🔺)	8.6 s
thirdweb (minimal + tree-shaking)	5.73 KB (0%)	115 ms (0%)	187 ms (+3340.15% 🔺)	301 ms
thirdweb/chains (tree-shaking)	526 B (0%)	11 ms (0%)	69 ms (+1766.55% 🔺)	79 ms
thirdweb/react (minimal + tree-shaking)	19.13 KB (0%)	383 ms (0%)	136 ms (+1711.25% 🔺)	518 ms