The LlamaCloud MCP Server allows you to query multiple managed indexes on LlamaCloud through a TypeScript-based server, enabling efficient information retrieval.
Query Managed Indexes: Create tools to query specific LlamaCloud indexes
Tool Autogeneration: Automatically generates tool names based on index names (e.g.,
get_information_<index_name>)Customizable Configuration: Define tools using command-line arguments with index names and descriptions
Integration Support: Easily integrates with MCP clients like Claude Desktop, Windsurf, or Cursor
Development Features: Provides development tools including debugging via the MCP Inspector
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LlamaCloud MCP Serverquery the Tesla 10k index for information about their battery technology"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LlamaCloud MCP Server
A MCP server connecting to multiple managed indexes on LlamaCloud
This is a TypeScript-based MCP server that creates multiple tools, each connected to a specific managed index on LlamaCloud. Each tool is defined through command-line arguments.
Features
Tools
Creates a separate tool for each index you define
Each tool provides a
queryparameter to search its specific indexAuto-generates tool names like
get_information_index_namebased on index names
Related MCP server: Just Prompt
Installation
To use with your MCP Client (e.g. Claude Desktop, Windsurf or Cursor), add the following config to your MCP client config:
The LLAMA_CLOUD_PROJECT_NAME environment variable is optional and defaults to Default if not set.
For Claude, the MCP config can be found at:
On MacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:
%APPDATA%/Claude/claude_desktop_config.json
Tool Definition Format
In the args array of the MCP config, you can define multiple tools by providing pairs of --index and --description arguments. Each pair defines a new tool. You can also optionally specify --topK to limit the number of results.
For example:
Adds a tool for the 10k-SEC-Tesla LlamaCloud index to the MCP server. In this example, it's configured to return the top 5 results.
Development
Install dependencies:
Build the server:
For development with auto-rebuild:
To use the development version, replace in your MCP config npx @llamaindex/mcp-server-llamacloud with node ./build/index.js.
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
The Inspector will provide a URL to access debugging tools in your browser.