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

Lumify Sports Intelligence

Lumify

Agent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

mcp-hfspace MCP Server 🤗

evalstate

MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.

387

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797