home / mcp / llamacloud mcp server

LlamaCloud MCP Server

A MCP server connecting to managed indexes on LlamaCloud

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "run-llama-mcp-server-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>"
      }
    }
  }
}

You run a TypeScript-based MCP server that connects to multiple managed indices on LlamaCloud. It spins up separate tools, each targeting a specific index, so you can query multiple data sources through a single MCP server and keep results organized by index.

How to use

You use this MCP server with an MCP Client to access multiple managed indexes from LlamaCloud. Each index you configure becomes its own tool, allowing you to search that specific index and retrieve results through the same server. Tools are named automatically based on the index and expose a query parameter to perform searches.

How to install

Prerequisites: Node.js and npm (or npm-compatible tooling) must be installed on your system.

Install dependencies and build the server.

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

Configuration notes

The server configuration defines multiple tools by pairing --index with --description arguments in the MCP config. Each pair creates a new tool. You can optionally add --topK to cap the number of results returned for each tool.

Security and environment

The server requires an API key to access LlamaCloud. Provide your API key as LLAMA_CLOUD_API_KEY in the environment when launching the server.

Available tools

get_info_tesla

Tool to query the 10k-SEC-Tesla index and retrieve relevant results from Tesla-related SEC documents.

get_info_apple

Tool to query the 10k-SEC-Apple index and retrieve relevant results from Apple-related SEC documents.