docs: add mcp-cli usage to agent instructions - #847
Conversation
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Warning Review limit reached
Next review available in: 45 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (5)
📝 WalkthroughWalkthroughA new "MCP Servers" documentation section was added to AGENTS.md, describing usage of mcp-cli for accessing MCP servers, discovering commands, inspecting tool schemas, and preferring native MCP tools when available. ChangesAGENTS.md MCP Documentation
Estimated code review effort: 1 (Trivial) | ~2 minutes Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request adds a new 'MCP Servers' section to the AGENTS.md documentation, detailing guidelines for using the mcp-cli tool. The review feedback recommends explicitly documenting the 'call' command syntax to prevent AI agents from hallucinating execution subcommands.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
✅MegaLinter analysis: Success
Notices📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining See detailed reports in MegaLinter artifacts Your project could benefit from a custom flavor, which would allow you to run only the linters you need, and thus improve runtime performances. (Skip this info by defining
|
✅
|
| Descriptor | Linter | Files | Fixed | Errors | Warnings | Elapsed time |
|---|---|---|---|---|---|---|
| ✅ BASH | bash-exec | 3 | 0 | 0 | 0.01s | |
| ✅ BASH | shellcheck | 3 | 0 | 0 | 0.1s | |
| ✅ REPOSITORY | checkov | yes | no | no | 23.71s | |
| ✅ REPOSITORY | devskim | yes | no | no | 2.01s | |
| ✅ REPOSITORY | dustilock | yes | no | no | 0.01s | |
| ✅ REPOSITORY | gitleaks | yes | no | no | 1.48s | |
| ✅ REPOSITORY | grype | yes | no | no | 48.17s | |
| ✅ REPOSITORY | kingfisher | yes | no | no | 8.38s | |
| osv-scanner | yes | 1 | no | 0.13s | ||
| ✅ REPOSITORY | secretlint | yes | no | no | 1.82s | |
| ✅ REPOSITORY | syft | yes | no | no | 1.82s | |
| ✅ REPOSITORY | trivy | yes | no | no | 12.16s | |
| ✅ REPOSITORY | trivy-sbom | yes | no | no | 0.2s | |
| ✅ REPOSITORY | trufflehog | yes | no | no | 4.43s |
Detailed Issues
⚠️ REPOSITORY / osv-scanner - 1 error
Scanning dir .
Starting filesystem walk for root: /
End status: 39 dirs visited, 132 inodes visited, 0 Extract calls, 2.759615ms elapsed, 2.759795ms wall time
No package sources found, --help for usage information.
Notices
📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining SECURITY_SUGGESTIONS: false)
See detailed reports in MegaLinter artifacts
Your project could benefit from a custom flavor, which would allow you to run only the linters you need, and thus improve runtime performances. (Skip this info by defining FLAVOR_SUGGESTIONS: false)
- Documentation: Custom Flavors
- Command:
npx mega-linter-runner@9.5.0 --custom-flavor-setup --custom-flavor-linters BASH_EXEC,BASH_SHELLCHECK,REPOSITORY_CHECKOV,REPOSITORY_DEVSKIM,REPOSITORY_DUSTILOCK,REPOSITORY_GITLEAKS,REPOSITORY_GRYPE,REPOSITORY_OSV_SCANNER,REPOSITORY_SECRETLINT,REPOSITORY_SYFT,REPOSITORY_TRIVY,REPOSITORY_TRIVY_SBOM,REPOSITORY_TRUFFLEHOG,REPOSITORY_KINGFISHER
Show us your support by starring ⭐ the repository
✅
|
| Descriptor | Linter | Files | Fixed | Errors | Warnings | Elapsed time |
|---|---|---|---|---|---|---|
| ✅ ACTION | actionlint | 5 | 0 | 0 | 0.27s | |
| ✅ ACTION | zizmor | 5 | 0 | 0 | 0 | 0.62s |
| ✅ BASH | bash-exec | 3 | 0 | 0 | 0.01s | |
| ✅ BASH | shellcheck | 3 | 0 | 0 | 0.08s | |
| ✅ BASH | shfmt | 3 | 0 | 0 | 0 | 0.01s |
| ✅ COPYPASTE | jscpd | yes | no | no | 0.65s | |
| ✅ EDITORCONFIG | editorconfig-checker | 62 | 0 | 0 | 0.13s | |
| ✅ JSON | prettier | 2 | 0 | 0 | 0 | 0.33s |
| ✅ JSON | v8r | 2 | 0 | 0 | 1.98s | |
| ✅ MARKDOWN | markdownlint | 4 | 0 | 0 | 0 | 0.61s |
| ✅ MARKDOWN | markdown-table-formatter | 4 | 0 | 0 | 0 | 0.19s |
| ✅ REPOSITORY | checkov | yes | no | no | 22.94s | |
| ✅ REPOSITORY | gitleaks | yes | no | no | 1.75s | |
| ✅ REPOSITORY | git_diff | yes | no | no | 0.01s | |
| ✅ REPOSITORY | grype | yes | no | no | 52.8s | |
| osv-scanner | yes | 1 | no | 0.14s | ||
| ✅ REPOSITORY | secretlint | yes | no | no | 1.12s | |
| ✅ REPOSITORY | syft | yes | no | no | 2.32s | |
| ✅ REPOSITORY | trivy | yes | no | no | 8.75s | |
| ✅ REPOSITORY | trivy-sbom | yes | no | no | 0.17s | |
| ✅ REPOSITORY | trufflehog | yes | no | no | 3.94s | |
| lychee | 18 | 1 | 0 | 1.13s | ||
| ✅ YAML | prettier | 10 | 0 | 0 | 0 | 0.48s |
| ✅ YAML | v8r | 10 | 0 | 0 | 7.23s | |
| ✅ YAML | yamllint | 10 | 0 | 0 | 0.37s |
Detailed Issues
⚠️ SPELL / lychee - 1 error
📝 Summary
---------------------
🔍 Total...........19
🔗 Unique..........15
✅ Successful......18
⏳ Timeouts.........0
🔀 Redirected.......3
👻 Excluded.........0
❓ Unknown..........0
🚫 Errors...........1
⛔ Unsupported......1
Errors in chezmoi/private_dot_config/mcp/mcp_servers.json
[406] https://mcp.deepwiki.com/mcp (at 8:15) | Rejected status code: 406 Not Acceptable
Hint: Followed 3 redirects. You might want to consider replacing redirecting URLs with the resolved URLs. Use verbose mode (`-v`/`-vv`) to see redirection details.
Hint: You can configure accepted/rejected response codes with `-a` or `--accept`
⚠️ REPOSITORY / osv-scanner - 1 error
Scanning dir .
Starting filesystem walk for root: /
End status: 39 dirs visited, 132 inodes visited, 0 Extract calls, 6.350564ms elapsed, 6.350817ms wall time
No package sources found, --help for usage information.
Notices
📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining SECURITY_SUGGESTIONS: false)
See detailed reports in MegaLinter artifacts
Your project could benefit from a custom flavor, which would allow you to run only the linters you need, and thus improve runtime performances. (Skip this info by defining FLAVOR_SUGGESTIONS: false)
- Documentation: Custom Flavors
- Command:
npx mega-linter-runner@9.5.0 --custom-flavor-setup --custom-flavor-linters ACTION_ACTIONLINT,ACTION_ZIZMOR,BASH_EXEC,BASH_SHELLCHECK,BASH_SHFMT,COPYPASTE_JSCPD,EDITORCONFIG_EDITORCONFIG_CHECKER,JSON_V8R,JSON_PRETTIER,MARKDOWN_MARKDOWNLINT,MARKDOWN_MARKDOWN_TABLE_FORMATTER,REPOSITORY_CHECKOV,REPOSITORY_GIT_DIFF,REPOSITORY_GITLEAKS,REPOSITORY_GRYPE,REPOSITORY_OSV_SCANNER,REPOSITORY_SECRETLINT,REPOSITORY_SYFT,REPOSITORY_TRIVY,REPOSITORY_TRIVY_SBOM,REPOSITORY_TRUFFLEHOG,SPELL_LYCHEE,YAML_PRETTIER,YAML_YAMLLINT,YAML_V8R
Show us your support by starring ⭐ the repository
Provide ~/.config/mcp/mcp_servers.json for mcp-cli auto-discovery. Split ~/.claude/CLAUDE.md into a real file importing @AGENTS.md and symlink AGENTS.md to the canonical ~/.agents/AGENTS.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: YuXuan Tay <5795122+yxtay@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 participant
Summary
## MCP Serverssection tochezmoi/private_dot_agents/AGENTS.mdso AI agents know MCP servers are reachable via themcp-cliCLI.mcp-cli --helpfor the full command reference (config search paths, formats, examples) rather than duplicating it.Why
The
mcp-clibinary and~/.config/mcp/mcp_servers.jsonconfig are already provisioned (commitf259cd4), but nothing told agents to use them. This closes that gap.Placed in the shared
AGENTS.md(imported intoCLAUDE.mdvia@AGENTS.md) sincemcp-cliis agent-agnostic.🤖 Generated with Claude Code
Summary by CodeRabbit