LlamaCloud MCP Server

LlamaCloud MCP Server

What is LlamaCloud MCP Server about? Provides a TypeScript‑based MCP server that automatically generates separate tools for each LlamaCloud managed index you specify, allowing MCP clients to query those indexes directly.

How to use LlamaCloud MCP Server?

1. Install the package via npx in your MCP client configuration.
2. Define each tool by adding --index and --description pairs (optionally --topK) in the args array.
3. Set the environment variable LLAMA_CLOUD_API_KEY with your API key.
4. Restart the MCP client; the server will expose tools like get_information_<index_name> that accept a query parameter.

Key features of LlamaCloud MCP Server

• Generates a distinct tool per index definition.
• Auto‑creates descriptive tool names based on index names.
• Supports configurable topK to limit result count.
• Simple CLI‑style configuration using standard MCP args array.
• Debugging support via MCP Inspector script.

Use cases of LlamaCloud MCP Server

• Integrate SEC filings, product documentation, or any large corpus hosted on LlamaCloud into AI assistants.
• Provide domain‑specific search capabilities within Claude, Windsurf, Cursor, or other MCP‑compatible clients.
• Rapid prototyping of multi‑index knowledge bases without writing custom server code.

FAQ from the LlamaCloud MCP Server

• Do I need to build the project before using it? No, the npx command runs the pre‑published package directly.
• Can I change the project name? Set LLAMA_CLOUD_PROJECT_NAME environment variable; defaults to Default.
• How many indexes can I define? Any number; each --index/--description pair creates a new tool.
• What does --topK do? Limits the number of returned search results per query.
• How do I debug communication issues? Run npm run inspector to launch the MCP Inspector UI.

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 query parameter to search its specific index
• Auto-generates tool names like get_information_index_name based on index names

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.

{
  "mcpServers": {
    "llamacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@llamaindex/mcp-server-llamacloud",
        "--index",
        "10k-SEC-Tesla",
        "--description",
        "10k SEC documents from 2023 for Tesla",
        "--topK",
        "5",
        "--index",
        "10k-SEC-Apple",
        "--description",
        "10k SEC documents from 2023 for Apple"
      ],
      "env": {
        "LLAMA_CLOUD_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

For Claude, the MCP config can be found at:

• On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• On 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:

--index "10k-SEC-Tesla" --description "10k SEC documents from 2023 for Tesla" --topK 5

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:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

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:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.