Connectors · AI
LlamaCloud MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to LlamaCloud and the rest of your systems. It gives your agent 199 LlamaCloud actions (117 reads, 48 writes and 34 that wait for a confirmation) and holds the LlamaCloud credential itself, so the agent never does. It paces LlamaCloud's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "llamacloud.files.list", intent: "check which LlamaCloud account is connected"}# List Files · read · 1 upstream call- 199actionsin one signed file
- 117readlook, never change
- 48writecreate and update
- 34wait for a yesdestructive, confirmed first
Set up
Connect LlamaCloud in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect LlamaCloud.
Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
access_tokenLlamaCloud API key (llx-...)hostWhere your LlamaCloud lives: your host
account { op: "connections.requirements", service: "llamacloud" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "llamacloud.files.list" }# list files · read · 1 upstream callcheck { action: "llamacloud.directories.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
LlamaCloud at a glance
- Sign-in
- Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
access_token- Setup fields
host- Limits we pace to
- 300 calls a minute, per connection
- API covered
- Llama Platform API 0.1.0 (OpenAPI 3.1.0)
api.cloud.llamaindex.ai - Built from
- LlamaCloud's documentation, read 23 October 2026api.cloud.llamaindex.aidevelopers.llamaindex.ai
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 46 of 117 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 4, so ask can line LlamaCloud up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in LlamaCloud.
199 actions in 39 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 117readlook, never change
- 48writecreate and update
- 34destructivewait for a confirmation
Pipelines
157 read · 5 write · 3 destructive
Chat · List Pipelines · Run Search · Search Pipelines
Extraction agents
107 read · 2 write · 1 destructive
Generate Extraction Schema · List Extract Agents · List Extraction Agents · Validate Extraction Schema
Pipeline documents
95 read · 3 write · 1 destructive
List Pipeline Documents · Paginated List Pipeline Documents · Get Pipeline Document · Get Pipeline Document Status
Retrievers
95 read · 3 write · 1 destructive
List Retrievers · Query Retrievers · Retrieve · Direct Retrieve
Parsing jobs
88 read · 0 write · 0 destructive
Get Job · Get Parsing Job Details · Generate Presigned Url · Get Job Json Result
Split jobs
84 read · 2 write · 2 destructive
List Split Jobs · List Split Jobs · Get Split Job · Get Split Job
Agent data
73 read · 2 write · 2 destructive
Aggregate Agent Data · Search Agent Data · Get Agent Data · Create Agent Data
Extract
74 read · 1 write · 2 destructive
Generate Extraction Schema · List Extract Jobs · Validate Extraction Schema · Get Extract Job
31 more areas · 126 actions
- Pipeline files 7
- Data sinks 6
- Directory files 6
- Indexes 6
- Parse 6
- Webhook configs 6
- Chat sessions 5
- Classify 5
- Configurations 5
- Data sources 5
- Directories 5
- Extraction jobs 5
- Extraction runs 5
- Files 5
- Pipeline data sources 5
- Verify 5
- Batch processing 4
- Batches 4
- Embedding model configs 4
- Organizations 4
- Projects 4
- Retrieval 4
- File page figures 3
- Attachments 2
- Batch processing items 2
- File page screenshots 2
- Usage metrics 2
- Extraction 1
- Parsing 1
- Pipeline document chunks 1
- Pipeline files metadata 1
Top actions
The LlamaCloud API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 12 of LlamaCloud's 12 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
llamacloud.files.listList Files | List files with optional filtering and pagination. | read | content.file.list77 connectors |
llamacloud.directories.listList Directories | List Directories. | read | content.folder.list62 connectors |
llamacloud.projects.listList Projects | List projects in an organization. | read | work.project.list109 connectors |
llamacloud.files.getGet File | Get file metadata by ID. | read | content.file.get74 connectors |
llamacloud.directories.getGet Directory | Retrieve a directory by its identifier. | read | content.folder.get47 connectors |
llamacloud.projects.getGet Project | Get a project by ID. | read | work.project.get106 connectors |
llamacloud.directories.createCreate Directory | Create a new directory within the specified project. | write | content.folder.create62 connectors |
llamacloud.directories.updateUpdate Directory | Update directory metadata. | write | content.folder.update48 connectors |
llamacloud.files.deleteDelete File | Delete a file from the project. | destructive | content.file.delete68 connectors |
llamacloud.organizations.listList Organizations | List organizations the current user can access. | read | platform.tenant.list70 connectors |
llamacloud.organizations.getGet Organization | Get an organization by ID. | read | platform.tenant.get86 connectors |
llamacloud.parse.createParse File | Parse a file by file ID or URL. | write | this connector |
Try it
Prompts to paste into Claude.
Each one names the LlamaCloud actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Give me a one-line status for every active LlamaCloud project.
calls
llamacloud.projects.list - Writewrite
Create Directory in LlamaCloud. Show me exactly what you will send before you save it.
calls
llamacloud.directories.create
Governance for LlamaCloud
Destructive actions wait for a yes.
34 LlamaCloud actions are destructive. The first 10:
- Delete File
llamacloud.files.delete - Delete Directory
llamacloud.directories.delete - Delete Parse Job
llamacloud.parse.delete - Delete Extract Job
llamacloud.extract.delete - Delete Index
llamacloud.indexes.delete - Delete Classify Job
llamacloud.classify.delete - Delete Pipeline
llamacloud.pipelines.delete - Delete Agent Data
llamacloud.agent_data.delete - Delete Data Sink
llamacloud.data_sinks.delete - Delete Retriever
llamacloud.retrievers.delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Delete File?
intent: the user asked me to delete File
account { op: "keys.create", name: "llamacloud-agent", allowed_actions: ["llamacloud.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "llamacloud.files.delete", approver: "[email protected]" }, { match: "llamacloud.directories.delete", approver: "[email protected]" }, { match: "llamacloud.parse.delete", approver: "[email protected]" } ]}Cost
What LlamaCloud costs on actionlake.
Every LlamaCloud action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call LlamaCloud refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 199 LlamaCloud actions
- 199actions pageeach page of a long list is one call
- 46reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every LlamaCloud action.
199 actions by area: the id your agent calls, what it does, and its effect.
Pipelines15
llamacloud.pipelines.cancel_syncCancel Pipeline Syncdestructivellamacloud.pipelines.chatChatreadllamacloud.pipelines.copyCopy Pipelinewritellamacloud.pipelines.createCreate Pipelinewritellamacloud.pipelines.deleteDelete Pipelinedestructivellamacloud.pipelines.force_deleteForce Delete Pipelinedestructivellamacloud.pipelines.getGet Pipelinereadllamacloud.pipelines.get_playground_sessionGet Playground Sessionreadllamacloud.pipelines.get_statusGet Pipeline Statusreadllamacloud.pipelines.listList Pipelinesreadllamacloud.pipelines.retrieveRun Searchreadllamacloud.pipelines.searchSearch Pipelinesreadllamacloud.pipelines.syncSync Pipelinewritellamacloud.pipelines.updateUpdate Existing Pipelinewritellamacloud.pipelines.upsertUpsert Pipelinewrite
Extraction agents10
llamacloud.extraction_agents.createCreate Extraction Agentwritellamacloud.extraction_agents.deleteDelete Extraction Agentdestructivellamacloud.extraction_agents.generate_schemaGenerate Extraction Schemareadllamacloud.extraction_agents.getGet Extraction Agentreadllamacloud.extraction_agents.get_by_nameGet Extraction Agent By Namereadllamacloud.extraction_agents.get_defaultGet Or Create Default Extraction Agentreadllamacloud.extraction_agents.listList Extract Agentsreadllamacloud.extraction_agents.list_v1List Extraction Agentsreadllamacloud.extraction_agents.updateUpdate Extraction Agentwritellamacloud.extraction_agents.validate_schemaValidate Extraction Schemaread
Pipeline documents9
llamacloud.pipeline_documents.create_batchCreate Batch Pipeline Documentswritellamacloud.pipeline_documents.deleteDelete Pipeline Documentdestructivellamacloud.pipeline_documents.getGet Pipeline Documentreadllamacloud.pipeline_documents.get_statusGet Pipeline Document Statusreadllamacloud.pipeline_documents.get_status_countsGet Pipeline Document Status Countsreadllamacloud.pipeline_documents.listList Pipeline Documentsreadllamacloud.pipeline_documents.list_paginatedPaginated List Pipeline Documentsreadllamacloud.pipeline_documents.syncSync Pipeline Documentwritellamacloud.pipeline_documents.upsert_batchUpsert Batch Pipeline Documentswrite
Retrievers9
llamacloud.retrievers.createCreate Retrieverwritellamacloud.retrievers.deleteDelete Retrieverdestructivellamacloud.retrievers.getGet Retrieverreadllamacloud.retrievers.listList Retrieversreadllamacloud.retrievers.queryQuery Retrieversreadllamacloud.retrievers.retrieveRetrievereadllamacloud.retrievers.retrieve_directDirect Retrievereadllamacloud.retrievers.updateUpdate Retrieverwritellamacloud.retrievers.upsertUpsert Retrieverwrite
Parsing jobs8
llamacloud.parsing_jobs.getGet Jobreadllamacloud.parsing_jobs.get_detailsGet Parsing Job Detailsreadllamacloud.parsing_jobs.get_file_urlGenerate Presigned Urlreadllamacloud.parsing_jobs.get_json_resultGet Job Json Resultreadllamacloud.parsing_jobs.get_markdown_resultGet Job Resultreadllamacloud.parsing_jobs.get_parametersGet Job Parametersreadllamacloud.parsing_jobs.get_structured_resultGet Job Structured Resultreadllamacloud.parsing_jobs.get_text_resultGet Job Text Resultread
Split jobs8
llamacloud.split_jobs.cancelCancel Split Jobdestructivellamacloud.split_jobs.createCreate Split Jobwritellamacloud.split_jobs.create_betaCreate Split Jobwritellamacloud.split_jobs.deleteDelete Split Jobdestructivellamacloud.split_jobs.getGet Split Jobreadllamacloud.split_jobs.get_betaGet Split Jobreadllamacloud.split_jobs.listList Split Jobsreadllamacloud.split_jobs.list_betaList Split Jobsread
Agent data7
llamacloud.agent_data.aggregateAggregate Agent Datareadllamacloud.agent_data.createCreate Agent Datawritellamacloud.agent_data.deleteDelete Agent Datadestructivellamacloud.agent_data.delete_by_queryDelete Agent Data By Querydestructivellamacloud.agent_data.getGet Agent Datareadllamacloud.agent_data.searchSearch Agent Datareadllamacloud.agent_data.updateUpdate Agent Datawrite
Extract7
llamacloud.extract.cancelCancel Extract Jobdestructivellamacloud.extract.createCreate Extract Jobwritellamacloud.extract.deleteDelete Extract Jobdestructivellamacloud.extract.generate_schemaGenerate Extraction Schemareadllamacloud.extract.getGet Extract Jobreadllamacloud.extract.listList Extract Jobsreadllamacloud.extract.validate_schemaValidate Extraction Schemaread
Pipeline files7
llamacloud.pipeline_files.addAdd Files To Pipeline Apiwritellamacloud.pipeline_files.deleteDelete Pipeline Filedestructivellamacloud.pipeline_files.get_statusGet Pipeline File Statusreadllamacloud.pipeline_files.get_status_countsGet Pipeline File Status Countsreadllamacloud.pipeline_files.listList Pipeline Filesreadllamacloud.pipeline_files.list_v1List Pipeline Files2readllamacloud.pipeline_files.updateUpdate Pipeline Filewrite
Data sinks6
llamacloud.data_sinks.createCreate Data Sinkwritellamacloud.data_sinks.deleteDelete Data Sinkdestructivellamacloud.data_sinks.getGet Data Sinkreadllamacloud.data_sinks.listList Data Sinksreadllamacloud.data_sinks.list_v1List Data Sinksreadllamacloud.data_sinks.updateUpdate Data Sinkwrite
Directory files6
llamacloud.directory_files.bulk_deleteBulk Delete Directory Filesdestructivellamacloud.directory_files.createAdd Directory Filewritellamacloud.directory_files.deleteDelete Directory Filedestructivellamacloud.directory_files.getGet Directory Filereadllamacloud.directory_files.listList Directory Filesreadllamacloud.directory_files.updateUpdate Directory Filewrite
Indexes6
llamacloud.indexes.cancel_syncCancel Index Syncdestructivellamacloud.indexes.createCreate Indexwritellamacloud.indexes.deleteDelete Indexdestructivellamacloud.indexes.getGet Indexreadllamacloud.indexes.listList Indexesreadllamacloud.indexes.syncSync Indexwrite
Parse6
llamacloud.parse.cancelCancel Parse Jobdestructivellamacloud.parse.createParse Filewritellamacloud.parse.deleteDelete Parse Jobdestructivellamacloud.parse.getGet Parse Jobreadllamacloud.parse.listList Parse Jobsreadllamacloud.parse.list_versionsList Parse Versionsread
Webhook configs6
llamacloud.webhook_configs.createCreate Webhook Configwritellamacloud.webhook_configs.deleteDelete Webhook Configdestructivellamacloud.webhook_configs.getGet Webhook Configreadllamacloud.webhook_configs.listList Webhook Configsreadllamacloud.webhook_configs.queryQuery Webhook Configsreadllamacloud.webhook_configs.updateUpdate Webhook Configwrite
Chat sessions5
llamacloud.chat_sessions.createCreate Sessionwritellamacloud.chat_sessions.deleteDelete Sessiondestructivellamacloud.chat_sessions.getGet Full Sessionreadllamacloud.chat_sessions.get_summaryGet Session Summaryreadllamacloud.chat_sessions.listList Sessionsread
Classify5
llamacloud.classify.cancelCancel Classify Jobdestructivellamacloud.classify.createCreate Classify Jobwritellamacloud.classify.deleteDelete Classify Jobdestructivellamacloud.classify.getGet Classify Jobreadllamacloud.classify.listList Classify Jobsread
Configurations5
llamacloud.configurations.createCreate Configurationwritellamacloud.configurations.deleteDelete Configurationdestructivellamacloud.configurations.getGet Configurationreadllamacloud.configurations.listList Configurationsreadllamacloud.configurations.updateUpdate Configurationwrite
Data sources5
llamacloud.data_sources.createCreate Data Sourcewritellamacloud.data_sources.deleteDelete Data Sourcedestructivellamacloud.data_sources.getGet Data Sourcereadllamacloud.data_sources.listList Data Sourcesreadllamacloud.data_sources.updateUpdate Data Sourcewrite
Directories5
llamacloud.directories.createCreate Directorywritellamacloud.directories.deleteDelete Directorydestructivellamacloud.directories.getGet Directoryreadllamacloud.directories.listList Directoriesreadllamacloud.directories.updateUpdate Directorywrite
Extraction jobs5
llamacloud.extraction_jobs.getGet Jobreadllamacloud.extraction_jobs.get_resultGet Job Resultreadllamacloud.extraction_jobs.listList Jobsreadllamacloud.extraction_jobs.runRun Jobwritellamacloud.extraction_jobs.run_batchRun Batch Jobswrite
Extraction runs5
llamacloud.extraction_runs.deleteDelete Extraction Rundestructivellamacloud.extraction_runs.getGet Runreadllamacloud.extraction_runs.get_by_jobGet Run By Job Idreadllamacloud.extraction_runs.get_latest_from_uiGet Latest Run From Uireadllamacloud.extraction_runs.listList Extract Runsread
Files5
llamacloud.files.deleteDelete Filedestructivellamacloud.files.getGet Filereadllamacloud.files.get_content_urlRead File Contentreadllamacloud.files.listList Filesreadllamacloud.files.queryQuery Filesread
Pipeline data sources5
llamacloud.pipeline_data_sources.addAdd Data Sources To Pipelinewritellamacloud.pipeline_data_sources.get_statusGet Pipeline Data Source Statusreadllamacloud.pipeline_data_sources.listList Pipeline Data Sourcesreadllamacloud.pipeline_data_sources.syncSync Pipeline Data Sourcewritellamacloud.pipeline_data_sources.updateUpdate Pipeline Data Sourcewrite
Verify5
llamacloud.verify.cancelCancel Verify Jobdestructivellamacloud.verify.createCreate Verify Jobwritellamacloud.verify.getGet Verify Jobreadllamacloud.verify.get_detailsGet Verify Job Detailsreadllamacloud.verify.listList Verify Jobsread
Batch processing4
llamacloud.batch_processing.cancelCancel Batch Jobdestructivellamacloud.batch_processing.createCreate Batch Jobwritellamacloud.batch_processing.get_statusGet Batch Job Statusreadllamacloud.batch_processing.listList Batch Jobsread
Batches4
llamacloud.batches.cancelCancel Batchdestructivellamacloud.batches.createCreate Batchwritellamacloud.batches.getGet Batchreadllamacloud.batches.listList Batchesread
Embedding model configs4
llamacloud.embedding_model_configs.createCreate a new Embedding Model Configurationwritellamacloud.embedding_model_configs.deleteDelete Embedding Model Configdestructivellamacloud.embedding_model_configs.listList Embedding Model Configsreadllamacloud.embedding_model_configs.updateUpdate Embedding Model Configwrite
Organizations4
llamacloud.organizations.getGet Organizationreadllamacloud.organizations.get_v1Get Organizationreadllamacloud.organizations.listList Organizationsreadllamacloud.organizations.list_v1List Organizationsread
Projects4
llamacloud.projects.getGet Projectreadllamacloud.projects.get_v1Get Projectreadllamacloud.projects.listList Projectsreadllamacloud.projects.list_v1List Projectsread
Retrieval4
llamacloud.retrieval.find_filesFind Filesreadllamacloud.retrieval.grep_fileGrep Filereadllamacloud.retrieval.read_fileRead Filereadllamacloud.retrieval.retrieveRetrieveread
File page figures3
llamacloud.file_page_figures.create_presigned_urlGenerate File Page Figure Presigned Urlreadllamacloud.file_page_figures.getList File Page Figuresreadllamacloud.file_page_figures.listList File Pages Figuresread
Attachments2
llamacloud.attachments.getGet Attachmentreadllamacloud.attachments.listList Attachmentsread
Batch processing items2
llamacloud.batch_processing_items.get_processing_resultsGet Item Processing Resultsreadllamacloud.batch_processing_items.listList Batch Job Itemsread
File page screenshots2
llamacloud.file_page_screenshots.create_presigned_urlGenerate File Page Screenshot Presigned Urlreadllamacloud.file_page_screenshots.listList File Page Screenshotsread
Usage metrics2
llamacloud.usage_metrics.aggregateAggregate Usage Metricsreadllamacloud.usage_metrics.listList Usage Metricsread
Extraction1
llamacloud.extraction.run_statelessExtract Statelesswrite
Parsing1
llamacloud.parsing.list_supported_file_extensionsGet Supported File Extensionsread
Pipeline document chunks1
llamacloud.pipeline_document_chunks.listList Pipeline Document Chunksread
Pipeline files metadata1
llamacloud.pipeline_files_metadata.deleteDelete Pipeline Files Metadatadestructive
Questions
The LlamaCloud MCP server, answered.
Is there a LlamaCloud MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 199 LlamaCloud actions across pipelines, extraction agents, pipeline documents and retrievers, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by LlamaCloud.
What do I need to connect LlamaCloud?
LlamaCloud API key (llx-...). Plus your host. The free call account { op: "connections.requirements", service: "llamacloud" } lists exactly what to paste.
Can an AI agent delete or change things in LlamaCloud?
Only if its key allows it, and only with an explicit confirmation. 34 LlamaCloud actions are destructive, including delete File, delete Directory and delete Parse Job. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my LlamaCloud API limit?
actionlake paces every call to the limits in the LlamaCloud service file: 300 calls a minute per connection. Repeated reads are answered from cache (46 LlamaCloud actions can be), which never reaches LlamaCloud.
What does a LlamaCloud action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (199 LlamaCloud actions page). Cache hits, searches, dry runs and calls LlamaCloud refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which LlamaCloud API does it cover?
The Llama Platform API 0.1.0 (OpenAPI 3.1.0) at api.cloud.llamaindex.ai by default, or the base URL set when you connect. It is built from LlamaCloud's documentation as read on 23 October 2026. 199 actions in 39 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my LlamaCloud data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your LlamaCloud credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent LlamaCloud today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.