Introduction
The Agility Knowledgebase MCP server gives AI assistants direct access to the Agility CMS documentation (this site!).
The Agility Knowledgebase MCP server gives AI assistants direct access to the Agility CMS documentation. It implements the Model Context Protocol (MCP) standard, allowing tools like Claude, ChatGPT, Gemini, Cursor, Windsurf, and other MCP-compatible agents to search and read documentation articles without leaving their interface.
This is separate from the Agility CMS MCP server, which provides content management operations (creating, updating, and managing content). The Knowledgebase MCP server is read-only and focused on searching the documentation you're reading right now.
When you're building with Agility CMS and using an AI coding assistant, the assistant can query the Agility documentation directly to answer your questions, look up API details, or find relevant guides — all without you needing to copy and paste documentation into your chat.
Example use cases:
https://docs.agilitycms.com/docs/api/mcp
Searches across all Agility CMS documentation articles. Returns results formatted as markdown with full URLs, descriptions, categories, and content snippets.
Parameters:
query (string, required) — Your search query. Natural language works best.page (number, optional) — Page number for pagination (0-based). Omit for the first page.Returns: Up to 10 results per page, with total hit count and page information. Each result includes a link to the full article and an objectID you can pass to fetch_doc for the complete content.
Retrieves the full content of a specific article by its ID. Use this after searching to get complete article text for in-depth analysis.
Parameters:
objectID (string, required) — The article's ID from search results.Returns: Full article content formatted as markdown, including the title, full URL, description, section headings, category, and body text.
claude_desktop_config.json{
"mcpServers": {
"agility-knowledgebase": {
"url": "https://docs.agilitycms.com/docs/api/mcp"
}
}
}
Add to your project's .mcp.json:
{
"mcpServers": {
"agility-knowledgebase": {
"url": "https://docs.agilitycms.com/docs/api/mcp"
}
}
}
Or add it via the command line:
claude mcp add agility-knowledgebase --transport http https://docs.agilitycms.com/docs/api/mcp
https://docs.agilitycms.com/docs/api/mcphttps://docs.agilitycms.com/docs/api/mcpAdd to .cursor/mcp.json in your project root:
{
"mcpServers": {
"agility-knowledgebase": {
"url": "https://docs.agilitycms.com/docs/api/mcp"
}
}
}
Add to your Windsurf MCP configuration file:
{
"mcpServers": {
"agility-knowledgebase": {
"url": "https://docs.agilitycms.com/docs/api/mcp"
}
}
}
Any MCP-compatible client that supports Streamable HTTP transport can connect. Use the server URL:
https://docs.agilitycms.com/docs/api/mcp
No authentication is required. The server supports the standard MCP protocol (JSON-RPC 2.0 over HTTP) and does not require SSE support from the client.
The server is built with the mcp-handler package and deployed on Vercel. It queries the same Algolia search index that powers the search bar on this documentation site.