MCP.so
Sign In

LlamaCloud MCP Server

@run-llama

Repository

About LlamaCloud MCP Server

A MCP server connecting to managed indexes on LlamaCloud

#llamacloud#mcp-server#managed-index

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
      }
    }
  }
}

Tools

1

generates tool names like `get_information_index_name` based on index names

Overview

What is LlamaCloud MCP Server?

LlamaCloud MCP Server is a TypeScript-based MCP server that connects to multiple managed indexes on LlamaCloud. It creates separate MCP tools for each index, allowing users to query their LlamaCloud documents through an MCP client.

How to use LlamaCloud MCP Server?

Configure the server in your MCP client (e.g., Claude Desktop, Windsurf, or Cursor) by adding an entry with command npx -y @llamaindex/mcp-server-llamacloud and passing --index, --description, and optionally --topK arguments for each index. Set the LLAMA_CLOUD_API_KEY environment variable to your API key.

Key features of LlamaCloud MCP Server

  • Creates a separate tool for each defined index
  • Each tool provides a query parameter for searching
  • Auto-generates tool names like get_information_index_name
  • Supports optional --topK to limit results per tool

Use cases of LlamaCloud MCP Server

  • Querying 10k SEC documents for multiple companies from a single server
  • Searching indexed knowledge bases through an MCP client interface
  • Managing and querying multiple LlamaCloud projects within one agent

FAQ from LlamaCloud MCP Server

How do I configure the server for my MCP client?

Add a JSON entry to your MCP client config with command npx -y @llamaindex/mcp-server-llamacloud, provide --index and --description pairs, and set LLAMA_CLOUD_API_KEY in the env block.

Where can I find my MCP client configuration file?

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%/Claude/claude_desktop_config.json.

How do I define multiple indexes (tools)?

Repeat the --index and --description arguments in the args array. Each pair creates a new tool. Optionally add --topK after a pair to limit its results.

What environment variables are required?

LLAMA_CLOUD_API_KEY is required. LLAMA_CLOUD_PROJECT_NAME is optional and defaults to Default if not set.

How can I debug the server?

Use the MCP Inspector by running npm run inspector from the project directory. It provides a URL with debugging tools for stdio-based MCP servers.

Frequently asked questions

How do I configure the server for my MCP client?

Add a JSON entry to your MCP client config with command `npx -y @llamaindex/mcp-server-llamacloud`, provide `--index` and `--description` pairs, and set `LLAMA_CLOUD_API_KEY` in the `env` block.

Where can I find my MCP client configuration file?

On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`. On Windows: `%APPDATA%/Claude/claude_desktop_config.json`.

How do I define multiple indexes (tools)?

Repeat the `--index` and `--description` arguments in the `args` array. Each pair creates a new tool. Optionally add `--topK` after a pair to limit its results.

What environment variables are required?

`LLAMA_CLOUD_API_KEY` is required. `LLAMA_CLOUD_PROJECT_NAME` is optional and defaults to `Default` if not set.

How can I debug the server?

Use the MCP Inspector by running `npm run inspector` from the project directory. It provides a URL with debugging tools for stdio-based MCP servers.

Comments

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

run-llama

More AI & Agents MCP servers

Simplepages

Simplepages

Build and edit landing pages and websites from your AI assistant, and pull how they are performing.

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur

Plainpaper

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

L

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

1

Sphere

dtajitdinov-aris

Open marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.