React Data GridAG Grid Model Context Protocol (MCP) Server

AG Grid's Model Context Protocol (MCP) server provides LLMs with framework and version specific knowledge to help developers integrate and maintain their AG Grid code.

Overview Copy Link

The core feature of the AG MCP Server is an LLM optimized search tool which will provide additional context, (e.g. version specific documentation, examples, and references), in a condensed markdown format, minimising the amount of context used.

More specifically, the AG MCP Server is made up of Tools, Prompts and Resources:

• Tools - Schema defined interfaces that enable AI models to perform actions, including searching the docs and detecting & setting the current AG Grid version.
• Prompts - Pre-configured actions that allow you to perform common actions, such as creating new grids, or migrating to later versions.
• Resources - Documentation, examples, and API definitions/interfaces in condensed markdown.

Each of these components are available to your LLM whenever it needs more information on how to implement AG Grid features, and can also be accessed directly.

Architecture Copy Link

At a high-level, the AG MCP Server works as follows:

1. Prompt submitted to LLM client, e.g. Claude, Cursor, CoPilot, ChatGPT, etc...
2. LLM accesses ag-mcp server and requests additional context, via a tool call, pre-built prompt, or by requesting specific resources.
3. ag-mcp uses an LLM optimised search tool to return version-specific information, such as docs, examples, and api refs in condensed markdown.
4. LLM uses this additional context to provide more accurate responses.

Installation Copy Link

To install and use ag-mcp with your LLM client, provide the npx ag-mcp command in the normal process for adding an MCP Server.

{
  "mcpServers": {
    "ag-mcp": {
      "command": "npx",
      "args": ["ag-mcp"]
    }
  }
}

"servers": {
  "ag-mcp": {
    "command": "npx",
    "args": [
      "ag-mcp"
    ],
    "type": "stdio"
  }
  // other MCP servers...
},

claude mcp add ag-mcp npx ag-mcp

Getting Started Copy Link

Once the MCP is installed, your LLM will automatically leverage the AG MCP Server to access additional context, based on your prompt. Tools, Prompts and Resources can also be accessed directly, as demonstrated below.

Refer to your LLM documentation for specific instructions on accessing MCP features.

Prompts Copy Link

Prompts are pre-configured actions that allow you to perform common actions, such as creating a new grid, or migrating to a later version.

AG MCP currently provides two prompts:

• quick-start - Get started with AG Grid in any framework
• upgrade-grid - Migrate to a newer version of AG Grid

Create a New Grid Copy Link

The quick-start prompt can be triggered directly from your LLM client. This creates a list of instructions for your LLM to follow when creating a new AG Grid project or adding AG Grid to an existing project.

You can pass additional context, requirements or instructions to your LLM as arguments to this prompt to fine tune the type of data grid you want the LLM to create.

/ag-mcp:quick-start {additional-context}

mcp.ag-mcp.quick-start {additional-context}

/ag-mcp:quick-start {additional-context}

Migrate to a New Version Copy Link

The upgrade-grid prompt creates a step by step plan to help migrate from your current version to the provided version. This is given to the LLM to execute, calling back to the MCP server as needed. It takes a version by version approach, making sure each version is correct before continuing.

To trigger the upgrade-grid prompt, enter the following command in your LLM prompt:

/ag-mcp:upgrade-grid {additional-context}

mcp.ag-mcp.upgrade-grid {additional-context}

/ag-mcp:upgrade-grid {additional-context}

Resources (Docs, API & Example Search) Copy Link

Resources allow servers to share data that provides context to language models, such as files, database schemas, or application-specific information.

There are currently three sets of resources available:

• articles - Access to the full AG Grid documentation at the correct version.
• definitions - API definitions and interfaces
• examples - A library of AG Grid implementation examples in your framework.

Your LLM can access these resources whenever it needs more information on how to implement AG Grid features.

To directly reference articles, definitions or examples, use the following steps depending on your LLM provider of choice:

$ Referencing ag-mcp:ag-mcp://articles, create a new cell renderer that displays a button.

Tools Copy Link

Tools are schema-defined interfaces that enable AI models to perform actions. Each tool defines a specific operation with typed inputs and outputs, and the model automatically requests tool execution based on context.

Tools can be called manually by entering the tool name as a prompt into your LLM, and passing the relevant params. Refer to your LLM documentation for specific instructions.

AG-MCP currently provides four tools:

• search_docs - Search the documents for the currently installed version of AG Grid.
• detect_version - Infers the version and framework of AG Grid installed in your repo.
• set_version - Manually set the version of your repo (useful in monorepos).
• list_versions - List all available AG Grid versions from the API to see what versions are available for migration or reference.

Search Docs Copy Link

Search AG Grid documentation for the detected or latest version. Use this to find details on features, APIs, configurations, and troubleshooting. Supports natural language queries.

Parameters Copy Link

Detect Version Copy Link

Detect the AG Grid version and framework in the current project by analyzing package.json and dependencies. Use this to understand the project setup.

Parameters Copy Link

Set Version Copy Link

Set the AG Grid version and framework to use for documentation searches and resources. Use this when working with a specific version or framework combination.

Parameters Copy Link

Config Copy Link

Config, such as project roots and versions, is stored in your cache folder. For example, in MacOS it will be stored in ~/Library/Preferences/ag-mcp.