feat: agents mcp #26617
Open
feat: agents mcp #26617
+32
−1
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Adds documentation for the new Agents SDK Documentation MCP server that provides token-efficient search of Cloudflare Agents SDK documentation. Related to cloudflare/agents#643 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
threepointone
requested review from
a team,
elithrar,
irvinebroque,
rita3ko and
thomasgauvin
as code owners
github-actions
bot
added
product:agents
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
Contributor
|
Preview URL: https://1eca4ada.preview.developers.cloudflare.com Files with changes (up to 15) |
threepointone
commented
Nov 19, 2025
| | [Cloudflare One CASB server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/cloudflare-one-casb) | Quickly identify any security misconfigurations for SaaS applications to safeguard users & data | `https://casb.mcp.cloudflare.com/mcp` | | ||
| | [GraphQL server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/graphql/) | Get analytics data using Cloudflare’s GraphQL API | `https://graphql.mcp.cloudflare.com/mcp` | | ||
| | [GraphQL server](https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/graphql/) | Get analytics data using Cloudflare's GraphQL API | `https://graphql.mcp.cloudflare.com/mcp` | | ||
| | [Agents SDK Documentation server](https://github.com/cloudflare/agents/tree/main/site/agents) | Token-efficient search of the Cloudflare Agents SDK documentation | `https://agents.mcp.cloudflare.com/mcp` | |
Contributor
Author
There was a problem hiding this comment.
Suggested change
| | [Agents SDK Documentation server](https://github.com/cloudflare/agents/tree/main/site/agents) | Token-efficient search of the Cloudflare Agents SDK documentation | `https://agents.mcp.cloudflare.com/mcp` | | |
| | [Agents SDK Documentation server](https://github.com/cloudflare/agents/tree/main/site/agents) | Token-efficient search of the Cloudflare Agents SDK documentation | `https://agents.cloudflare.com/mcp` | |
Comment on lines
+38
to
+67
| ## Agents SDK Documentation server | ||
|
|
||
| The Agents SDK Documentation server provides a token-efficient search tool for the Cloudflare Agents SDK documentation. This server is particularly useful when building with the Agents SDK, allowing you to quickly find relevant documentation without consuming excessive tokens. | ||
|
|
||
| ### Available tools | ||
|
|
||
| The server exposes one tool: | ||
|
|
||
| - **search-agent-docs**: Search the Cloudflare Agents SDK documentation using natural language queries | ||
| - **query** (string): Query string to search for (for example, `agent hibernate`, `schedule tasks`) | ||
| - **k** (number, optional): Number of results to return (default: 5) | ||
|
|
||
| ### How it works | ||
|
|
||
| The server fetches documentation from GitHub, chunks it using a recursive chunker, and indexes it with Orama. The index is cached in KV for one day. Search uses BM25 with stemming enabled, which allows natural language queries like "hibernation" to match with "hibernate" for better results. | ||
|
|
||
| ### Usage example | ||
|
|
||
| Connect to the server at `https://agents.mcp.cloudflare.com/mcp` in your MCP client. You can then use queries like: | ||
|
|
||
| - `agent hibernate` - Find information about agent hibernation | ||
| - `schedule tasks` - Learn about task scheduling | ||
| - `tool calling` - Discover how to implement tool calling | ||
|
|
||
| The server returns relevant documentation chunks with their file names and full content URLs, making it easy to find the information you need while building agents. | ||
|
|
||
| ### Rate limiting | ||
|
|
||
| The server is designed to avoid GitHub rate limiting by caching documentation. If you are self-hosting this server, you can set the `GITHUB_TOKEN` environment variable to increase your rate limits. | ||
|
|
Contributor
Author
There was a problem hiding this comment.
Suggested change
| ## Agents SDK Documentation server | |
| The Agents SDK Documentation server provides a token-efficient search tool for the Cloudflare Agents SDK documentation. This server is particularly useful when building with the Agents SDK, allowing you to quickly find relevant documentation without consuming excessive tokens. | |
| ### Available tools | |
| The server exposes one tool: | |
| - **search-agent-docs**: Search the Cloudflare Agents SDK documentation using natural language queries | |
| - **query** (string): Query string to search for (for example, `agent hibernate`, `schedule tasks`) | |
| - **k** (number, optional): Number of results to return (default: 5) | |
| ### How it works | |
| The server fetches documentation from GitHub, chunks it using a recursive chunker, and indexes it with Orama. The index is cached in KV for one day. Search uses BM25 with stemming enabled, which allows natural language queries like "hibernation" to match with "hibernate" for better results. | |
| ### Usage example | |
| Connect to the server at `https://agents.mcp.cloudflare.com/mcp` in your MCP client. You can then use queries like: | |
| - `agent hibernate` - Find information about agent hibernation | |
| - `schedule tasks` - Learn about task scheduling | |
| - `tool calling` - Discover how to implement tool calling | |
| The server returns relevant documentation chunks with their file names and full content URLs, making it easy to find the information you need while building agents. | |
| ### Rate limiting | |
| The server is designed to avoid GitHub rate limiting by caching documentation. If you are self-hosting this server, you can set the `GITHUB_TOKEN` environment variable to increase your rate limits. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Synced from cloudflare/agents#643
This PR adds documentation for the new Agents SDK Documentation MCP server that provides token-efficient search of the Cloudflare Agents SDK documentation.
Changes:
Original PR: cloudflare/agents#643