langflow-mcp-server 3.1.0 → 4.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +228 -79
  2. package/dist/__tests__/fixtures/vertices.d.ts +1 -2
  3. package/dist/__tests__/fixtures/vertices.d.ts.map +1 -1
  4. package/dist/__tests__/fixtures/vertices.js +1 -5
  5. package/dist/__tests__/fixtures/vertices.js.map +1 -1
  6. package/dist/mcp/server-consolidated.d.ts +13 -0
  7. package/dist/mcp/server-consolidated.d.ts.map +1 -1
  8. package/dist/mcp/server-consolidated.js +713 -44
  9. package/dist/mcp/server-consolidated.js.map +1 -1
  10. package/dist/mcp/server.d.ts.map +1 -1
  11. package/dist/mcp/server.js +749 -50
  12. package/dist/mcp/server.js.map +1 -1
  13. package/dist/mcp/tools-consolidated.d.ts.map +1 -1
  14. package/dist/mcp/tools-consolidated.js +722 -43
  15. package/dist/mcp/tools-consolidated.js.map +1 -1
  16. package/dist/mcp/tools.d.ts.map +1 -1
  17. package/dist/mcp/tools.js +1701 -66
  18. package/dist/mcp/tools.js.map +1 -1
  19. package/dist/mcp/validation-consolidated.d.ts +681 -9
  20. package/dist/mcp/validation-consolidated.d.ts.map +1 -1
  21. package/dist/mcp/validation-consolidated.js +635 -15
  22. package/dist/mcp/validation-consolidated.js.map +1 -1
  23. package/dist/mcp/validation.d.ts +769 -11
  24. package/dist/mcp/validation.d.ts.map +1 -1
  25. package/dist/mcp/validation.js +600 -11
  26. package/dist/mcp/validation.js.map +1 -1
  27. package/dist/services/langflow-client.d.ts +133 -51
  28. package/dist/services/langflow-client.d.ts.map +1 -1
  29. package/dist/services/langflow-client.js +1102 -154
  30. package/dist/services/langflow-client.js.map +1 -1
  31. package/dist/types/index.d.ts +395 -4
  32. package/dist/types/index.d.ts.map +1 -1
  33. package/package.json +16 -13
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![npm downloads](https://img.shields.io/npm/dm/langflow-mcp-server.svg)](https://www.npmjs.com/package/langflow-mcp-server)
5
5
  [![GitHub release](https://img.shields.io/github/v/release/nobrainer-tech/langflow-mcp)](https://github.com/nobrainer-tech/langflow-mcp/releases)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
- [![Tests](https://img.shields.io/badge/tests-771%20passing-brightgreen.svg)](https://github.com/nobrainer-tech/langflow-mcp)
7
+ [![Tests](https://img.shields.io/badge/tests-780%20passing-brightgreen.svg)](https://github.com/nobrainer-tech/langflow-mcp)
8
8
  [![MCP Badge](https://lobehub.com/badge/mcp/nobrainer-tech-langflow-mcp)](https://lobehub.com/mcp/nobrainer-tech-langflow-mcp)
9
9
 
10
10
  A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to Langflow workflow automation platform.
@@ -13,16 +13,18 @@ A Model Context Protocol (MCP) server that provides AI assistants with comprehen
13
13
 
14
14
  langflow-mcp-server serves as a bridge between Langflow's workflow automation platform and AI models, enabling them to understand and work with Langflow flows effectively.
15
15
 
16
- **API Compatibility**: This server is built on the [Langflow API documentation](https://docs.langflow.org/api) and supports Langflow API version **1.7.2**.
16
+ **API Compatibility**: This server is built on the [Langflow API documentation](https://docs.langflow.org/api) and supports Langflow API version **1.11.0**. Langflow 1.11.0 adds A2A (Agent-to-Agent) protocol endpoints, v2 workflow human-in-the-loop lifecycle (pending/resume/events) plus public execution, and external trusted-JWT / JIT-provisioning auth (config-only, no new tools), all on top of the 1.10.0 surface (RBAC/authz, Memory Bases, the Knowledge Base ingestion overhaul, extensions, agentic sandbox files) without breaking existing routes; this release covers them.
17
17
 
18
- ### v3.0.0 - Consolidated Tools Mode
18
+ **Versioning**: From `4.10.0` onward, the npm minor version mirrors the supported Langflow minor — `langflow-mcp-server@4.<langflow_minor>.x` targets Langflow `1.<langflow_minor>.x` (so `4.11.x` ↔ Langflow `1.11.x`, `4.10.x` ↔ Langflow `1.10.x`). The patch component is used for fixes within the same Langflow minor.
19
19
 
20
- Version 3.0.0 introduces **Consolidated Tools Mode** - a new architecture that groups 93 individual tools into **15 action-based tools**. This significantly reduces token usage and improves AI assistant context management.
20
+ ### Consolidated Tools Mode
21
+
22
+ **Consolidated Tools Mode** is an architecture that groups the 216 individual tools into **28 action-based meta-tools**. This significantly reduces token usage and improves AI assistant context management.
21
23
 
22
24
  | Mode | Tools | Best For |
23
25
  |------|-------|----------|
24
- | Standard | 93 tools | Full granular control |
25
- | Consolidated | 15 tools | Reduced token usage, better context |
26
+ | Standard | 216 tools | Full granular control |
27
+ | Consolidated | 28 tools | Reduced token usage, better context |
26
28
 
27
29
  To enable consolidated mode:
28
30
  ```bash
@@ -30,21 +32,34 @@ LANGFLOW_CONSOLIDATED_TOOLS=true
30
32
  ```
31
33
 
32
34
  **Consolidated tools:**
33
- - `flow` - All flow operations (list, get, create, update, delete, download, upload, etc.)
35
+ - `flow` - All flow operations (list, get, create, update, delete, download, upload, replace, expand, batch, public, note_translations)
34
36
  - `flow_execution` - Run flows (run, run_advanced, run_session, webhook, process, predict)
37
+ - `flow_version` - Flow versions and lifecycle events (list, create, get, delete, activate, get_events, create_event)
35
38
  - `build` - Build operations (start, status, cancel, vertices)
39
+ - `workflow` - Run and manage v2 workflows (run with request-level globals, get_result, stop, plus Langflow 1.11.0 HITL/public: pending, events, resume, run_public)
40
+ - `agentic` - Agentic assistant + sandbox (assist, check_config, execute, get_file, reset_session)
36
41
  - `folder` - Folder management (list, get, create, update, delete, download, upload)
37
42
  - `project` - Project management (list, get, create, update, delete, download, upload)
38
- - `variable` - Variable operations (list, create, update, delete)
39
- - `knowledge_base` - Knowledge base management (list, get, delete, bulk_delete, upload)
40
- - `file` - File operations (list, upload, download, delete, get_image)
41
- - `monitor` - Monitoring (builds, messages, sessions, transactions)
42
- - `user` - User management (list, get, get_current, update, reset_password)
43
- - `auth` - Authentication (login, auto_login, logout, refresh, api keys)
44
- - `store` - Component store (list, get, tags, likes)
43
+ - `variable` - Variable operations (list, create, update, delete, detect)
44
+ - `knowledge_base` - Knowledge base management (list, get, delete, bulk_delete, upload, create, preview/list chunks, ingest, cancel_ingest, test_connection, list_connectors, ingest_folder, ingest_connector, metadata_keys, list_runs, get_run)
45
+ - `memory` - Memory bases (create, list, get, list_sessions, list_messages, update, delete, flush, mismatch, regenerate) — experimental Langflow API
46
+ - `file` - Flow-scoped file operations (list, upload, download, delete, get_image)
47
+ - `file_v2` - User-scoped v2 files (list, upload, get, rename, delete, delete_all, batch_download, batch_delete)
48
+ - `monitor` - Monitoring (builds, messages, sessions, transactions, job_queue)
49
+ - `trace` - Execution traces (list, get, delete, delete_by_flow)
50
+ - `model` - Models and providers (list, providers, enabled, default get/set/delete, mapping, validate, options)
51
+ - `authz` - RBAC authorization (roles, role assignments, teams, shares, audit, my permissions)
52
+ - `user` - User management (list, get_current, update, reset_password, create)
53
+ - `auth` - Authentication (login, auto_login, logout, refresh, api keys, save_store_key)
54
+ - `store` - Component store (list, get, tags, likes, save_api_key, create, like, update_custom)
45
55
  - `registration` - User registration (get, register)
46
56
  - `validation` - Code/prompt validation (code, prompt)
47
- - `system` - System info (health, version, logs, pictures, voices)
57
+ - `mcp_server` - MCP server management (list, get, create, update, delete)
58
+ - `mcp_project` - MCP project config/install (get/update config, get_installed, install, composer_url)
59
+ - `extension` - Langflow extensions (reload, events)
60
+ - `response` - OpenAI-compatible responses (create)
61
+ - `system` - System info (health, version, logs, pictures, voices, session, webhook_events, health_check)
62
+ - `a2a` - A2A (Agent-to-Agent) protocol (list_agents, agent_card, jsonrpc) — Langflow 1.11.0
48
63
 
49
64
  It provides structured access to:
50
65
 
@@ -61,7 +76,7 @@ It provides structured access to:
61
76
 
62
77
  ### Prerequisites
63
78
 
64
- - Node.js installed on your system
79
+ - Node.js 20 or newer installed on your system
65
80
  - A running Langflow instance
66
81
  - Langflow API key
67
82
 
@@ -209,50 +224,81 @@ environment:
209
224
  - AUTH_TOKEN=your-secure-token
210
225
  ```
211
226
 
212
- ## Deprecated Tools
213
-
214
- ⚠️ **Important**: This server includes 4 deprecated tools that match deprecated endpoints in Langflow API 1.6.4:
215
- - `build_vertices` - Use `build_flow` instead
216
- - `get_vertex` - Use `build_flow` or `get_flow` instead
217
- - `stream_vertex_build` - Use `get_build_status` with streaming instead
218
- - `get_task_status` - Use `get_build_status` instead
219
-
220
- These tools are **enabled by default** but marked with ⚠️ warnings. To disable them, set:
221
- ```bash
222
- ENABLE_DEPRECATED_TOOLS=false
223
- ```
224
-
225
227
  ## Available MCP Tools
226
228
 
227
229
  Once connected, Claude can use:
228
- - **Standard mode**: 93 individual tools (97 with deprecated tools enabled)
229
- - **Consolidated mode**: 15 action-based tools (recommended for reduced token usage)
230
+ - **Standard mode**: 216 individual tools
231
+ - **Consolidated mode**: 28 action-based tools (recommended for reduced token usage)
232
+
233
+ > **Note**: Raw MCP transport endpoints (SSE/streamable, `/api/mcp/*`) and doc-rendering
234
+ > endpoints (`/docs`, `/redoc`, `/openapi.json`) are intentionally **not** exposed as
235
+ > tools — they are protocol/transport surfaces, not data operations.
230
236
 
231
- ### Standard Mode Tools (93 tools)
237
+ ### Standard Mode Tools (216 tools)
232
238
 
233
- ### Flow Management (6 tools)
239
+ ### Flow Management (13 tools)
234
240
  - **`create_flow`** - Create a new Langflow flow
235
241
  - **`list_flows`** - List all flows with pagination and filtering
236
242
  - **`get_flow`** - Get details of a specific flow by ID
237
243
  - **`update_flow`** - Update an existing flow
238
244
  - **`delete_flow`** - Delete a single flow
239
245
  - **`delete_flows`** - Delete multiple flows at once
246
+ - **`replace_flow`** - Replace a flow's full definition
247
+ - **`expand_flows`** - Expand flows with embedded component data
248
+ - **`upload_flow`** - Upload a flow from JSON data
249
+ - **`download_flows`** - Download multiple flows as JSON export
250
+ - **`get_basic_examples`** - Get pre-built example flows
251
+ - **`batch_create_flows`** - Create multiple flows in one operation
252
+ - **`get_public_flow`** - Get a public flow without authentication
240
253
 
241
- ### Flow Execution (2 tools)
254
+ ### Flow Execution (7 tools)
242
255
  - **`run_flow`** - Execute a flow with input configuration (supports streaming)
256
+ - **`run_flow_advanced`** - Advanced flow execution with full control
257
+ - **`run_flow_session`** - Execute a flow within a session context
243
258
  - **`trigger_webhook`** - Trigger a flow via webhook endpoint
259
+ - **`get_webhook_events`** - Get webhook trigger events for a flow
260
+ - **`process_flow`** - Legacy process endpoint for flows
261
+ - **`predict_flow`** - Legacy predict endpoint for flows
244
262
 
245
- ### Import/Export (3 tools)
246
- - **`upload_flow`** - Upload a flow from JSON data
247
- - **`download_flows`** - Download multiple flows as JSON export
248
- - **`get_basic_examples`** - Get pre-built example flows
263
+ ### Flow Versions & Events (7 tools)
264
+ - **`list_flow_versions`** - List versions of a flow
265
+ - **`create_flow_version`** - Create a new flow version
266
+ - **`get_flow_version`** - Get a specific flow version
267
+ - **`delete_flow_version`** - Delete a flow version
268
+ - **`activate_flow_version`** - Activate a specific flow version
269
+ - **`get_flow_events`** - Get lifecycle events for a flow
270
+ - **`create_flow_event`** - Create a lifecycle event for a flow
249
271
 
250
- ### Folder Management (5 tools)
272
+ ### Build Operations (6 tools)
273
+ - **`build_flow`** - Build/compile a flow and return job_id for async execution
274
+ - **`get_build_status`** - Poll build status and events for a specific job
275
+ - **`cancel_build`** - Cancel a running build job
276
+ - **`get_task_status`** - Get status of an async task
277
+ - **`build_vertices`** - Get vertex build order for a flow
278
+ - **`stream_vertex_build`** - Stream real-time build events for a vertex
279
+
280
+ ### Workflows (v2) (3 tools)
281
+ - **`run_workflow`** - Run a v2 workflow
282
+ - **`get_workflow_result`** - Get the result of a workflow run
283
+ - **`stop_workflow`** - Stop a running workflow
284
+
285
+ ### Agentic (3 tools)
286
+ - **`agentic_assist`** - Get agentic assistance for a flow component
287
+ - **`agentic_check_config`** - Check whether agentic features are configured
288
+ - **`agentic_execute`** - Execute an agentic flow by name
289
+
290
+ ### Responses (2 tools)
291
+ - **`create_response`** - Create an OpenAI-compatible response
292
+ - **`get_session`** - Get a response/conversation session
293
+
294
+ ### Folder Management (7 tools)
251
295
  - **`list_folders`** - List all folders with pagination
252
296
  - **`create_folder`** - Create a new folder
253
297
  - **`get_folder`** - Get folder details by ID
254
298
  - **`update_folder`** - Update folder name, description, or parent
255
299
  - **`delete_folder`** - Delete a folder
300
+ - **`download_folder`** - Download entire folder as archive
301
+ - **`upload_folder`** - Upload folder from archive
256
302
 
257
303
  ### Project Management (7 tools)
258
304
  - **`list_projects`** - List all projects with pagination
@@ -263,25 +309,25 @@ Once connected, Claude can use:
263
309
  - **`upload_project`** - Upload a project from JSON data
264
310
  - **`download_project`** - Download a project as JSON export
265
311
 
266
- ### Variable Management (4 tools)
312
+ ### Variable Management (5 tools)
267
313
  - **`list_variables`** - List all global variables
268
314
  - **`create_variable`** - Create a new variable
269
315
  - **`update_variable`** - Update variable properties
270
316
  - **`delete_variable`** - Delete a variable
317
+ - **`detect_variables`** - Detect variables referenced in a value/template
271
318
 
272
- ### Build Operations (3 tools)
273
- - **`build_flow`** - Build/compile a flow and return job_id for async execution
274
- - **`get_build_status`** - Poll build status and events for a specific job
275
- - **`cancel_build`** - Cancel a running build job
276
-
277
- ### Knowledge Base Management (4 tools)
319
+ ### Knowledge Base Management (11 tools)
278
320
  - **`list_knowledge_bases`** - List all available knowledge bases
321
+ - **`list_knowledge_bases_detailed`** - List knowledge bases with detailed metadata
279
322
  - **`get_knowledge_base`** - Get detailed information about a specific knowledge base
323
+ - **`create_knowledge_base`** - Create a new knowledge base
280
324
  - **`delete_knowledge_base`** - Delete a specific knowledge base
281
325
  - **`bulk_delete_knowledge_bases`** - Delete multiple knowledge bases at once
282
-
283
- ### Component Discovery (1 tool)
284
- - **`list_components`** - List all available Langflow components
326
+ - **`upload_knowledge_base`** - Upload a file to create/update a knowledge base
327
+ - **`preview_knowledge_base_chunks`** - Preview how a document will be chunked
328
+ - **`list_knowledge_base_chunks`** - List stored chunks for a knowledge base
329
+ - **`ingest_knowledge_base`** - Ingest documents into a knowledge base
330
+ - **`cancel_knowledge_base_ingest`** - Cancel an in-progress ingest job
285
331
 
286
332
  ### File Management (5 tools)
287
333
  - **`upload_file`** - Upload a file to a specific flow
@@ -290,73 +336,115 @@ Once connected, Claude can use:
290
336
  - **`delete_file`** - Delete a file from a flow
291
337
  - **`get_file_image`** - Get an image file from a flow
292
338
 
293
- ### Monitoring & Analytics (9 tools)
339
+ ### Files (v2) (8 tools)
340
+ - **`list_files_v2`** - List all user-scoped v2 files
341
+ - **`upload_file_v2`** - Upload a v2 file
342
+ - **`get_file_v2`** - Get v2 file metadata or content
343
+ - **`rename_file_v2`** - Rename a v2 file
344
+ - **`delete_file_v2`** - Delete a v2 file
345
+ - **`delete_all_files_v2`** - Delete all v2 files
346
+ - **`batch_download_files_v2`** - Download multiple v2 files
347
+ - **`batch_delete_files_v2`** - Delete multiple v2 files
348
+
349
+ ### Component Discovery & Custom Components (3 tools)
350
+ - **`list_components`** - List all available Langflow components
351
+ - **`create_custom_component`** - Create a new custom component
352
+ - **`update_custom_component`** - Update an existing custom component
353
+
354
+ ### Monitoring & Analytics (12 tools)
294
355
  - **`get_monitor_builds`** - Get build execution history for a flow
295
356
  - **`get_monitor_messages`** - Query chat/message history with filtering
296
357
  - **`get_monitor_message`** - Get details of a specific message
358
+ - **`update_monitor_message`** - Update a stored message
297
359
  - **`get_monitor_sessions`** - List all chat session IDs
298
360
  - **`get_monitor_session_messages`** - Get all messages for a session
299
361
  - **`migrate_monitor_session`** - Migrate messages between sessions
300
362
  - **`get_monitor_transactions`** - List transaction logs for a flow
301
363
  - **`delete_monitor_builds`** - Delete build history for a flow
302
364
  - **`delete_monitor_messages`** - Delete multiple messages by ID
303
-
304
- ### Vertex Operations ⚠️ *DEPRECATED* (3 tools)
305
- - **`build_vertices`** ⚠️ *DEPRECATED* - Get vertex build order for a flow (use `build_flow` instead)
306
- - **`get_vertex`** ⚠️ *DEPRECATED* - Get details of a specific vertex/component (use `build_flow` or `get_flow` instead)
307
- - **`stream_vertex_build`** ⚠️ *DEPRECATED* - Stream real-time build events for a vertex (use `get_build_status` with streaming instead)
365
+ - **`delete_monitor_session_messages`** - Delete all messages for a session
366
+ - **`delete_monitor_sessions`** - Delete chat sessions
367
+
368
+ ### Traces (4 tools)
369
+ - **`list_traces`** - List execution traces with filters
370
+ - **`get_trace`** - Get a specific execution trace
371
+ - **`delete_trace`** - Delete a specific trace
372
+ - **`delete_traces`** - Delete all traces for a flow
373
+
374
+ ### Shared Messages (5 tools)
375
+ - **`get_shared_messages`** - Get shared messages
376
+ - **`get_shared_sessions`** - Get shared sessions
377
+ - **`update_shared_message`** - Update a shared message
378
+ - **`migrate_shared_session`** - Migrate a shared session
379
+ - **`delete_shared_session`** - Delete a shared session
380
+
381
+ ### Models & Providers (12 tools)
382
+ - **`list_models`** - List available models
383
+ - **`list_model_providers`** - List all model providers
384
+ - **`list_enabled_providers`** - List enabled providers
385
+ - **`list_enabled_models`** - List enabled models
386
+ - **`set_enabled_models`** - Enable/disable models
387
+ - **`get_default_model`** - Get the default model for a type
388
+ - **`set_default_model`** - Set the default model for a type
389
+ - **`delete_default_model`** - Remove the default model for a type
390
+ - **`get_provider_variable_mapping`** - Get provider-to-variable mapping
391
+ - **`validate_model_provider`** - Validate provider credentials
392
+ - **`get_language_model_options`** - Get language model options
393
+ - **`get_embedding_model_options`** - Get embedding model options
308
394
 
309
395
  ### User Management (5 tools)
310
396
  - **`list_users`** - List all users (admin only)
311
397
  - **`get_current_user`** - Get current authenticated user info
312
- - **`get_user`** - Get details of a specific user
313
398
  - **`update_user`** - Update user profile information
314
399
  - **`reset_user_password`** - Reset password for a user (admin only)
400
+ - **`create_user`** - Create a new user (admin only)
315
401
 
316
402
  ### API Key Management (3 tools)
317
403
  - **`list_api_keys`** - List all API keys for the user
318
404
  - **`create_api_key`** - Create a new API key
319
405
  - **`delete_api_key`** - Delete an API key
320
406
 
321
- ### Custom Components (2 tools)
322
- - **`list_custom_components`** - List all custom components
323
- - **`create_custom_component`** - Create a new custom component
324
-
325
407
  ### Authentication (4 tools)
326
408
  - **`login`** - Authenticate with username and password
327
409
  - **`auto_login`** - Auto-login with stored credentials
328
410
  - **`refresh_token`** - Refresh authentication token
329
411
  - **`logout`** - Logout and invalidate session
330
412
 
331
- ### Store & Marketplace (6 tools)
413
+ ### Registration (2 tools)
414
+ - **`get_registration`** - Check whether registration is enabled
415
+ - **`register_user`** - Register a new user account
416
+
417
+ ### Store & Marketplace (9 tools)
332
418
  - **`check_store`** - Check if component store is enabled
333
419
  - **`check_store_api_key`** - Validate a store API key
420
+ - **`save_store_api_key`** - Save a store API key
334
421
  - **`list_store_components`** - Browse available components in the store
335
422
  - **`get_store_component`** - Get details of a store component
423
+ - **`create_store_component`** - Publish a component to the store
424
+ - **`like_store_component`** - Like a store component
336
425
  - **`list_store_tags`** - List all component tags in the store
337
426
  - **`get_user_likes`** - Get components liked by user
338
427
 
339
- ### Validation Tools (2 tools)
428
+ ### Validation (2 tools)
340
429
  - **`validate_code`** - Validate Python code for custom components
341
430
  - **`validate_prompt`** - Validate prompt template syntax
342
431
 
343
- ### Advanced Execution (3 tools)
344
- - **`run_flow_advanced`** - Advanced flow execution with full control
345
- - **`process_flow`** - Legacy process endpoint for flows
346
- - **`predict_flow`** - Legacy predict endpoint for flows
347
-
348
- ### Batch & Public Operations (3 tools)
349
- - **`get_public_flow`** - Get a public flow without authentication
350
- - **`batch_create_flows`** - Create multiple flows in one operation
351
- - **`get_task_status`** ⚠️ *DEPRECATED* - Get status of an async task (use `get_build_status` instead)
352
-
353
- ### Folder Operations (2 tools)
354
- - **`download_folder`** - Download entire folder as archive
355
- - **`upload_folder`** - Upload folder from archive
356
-
357
- ### Starter & Templates (2 tools)
432
+ ### MCP Servers (v2) (5 tools)
433
+ - **`list_mcp_servers`** - List MCP servers registered with Langflow
434
+ - **`get_mcp_server`** - Get an MCP server by name
435
+ - **`create_mcp_server`** - Create an MCP server
436
+ - **`update_mcp_server`** - Update an MCP server
437
+ - **`delete_mcp_server`** - Delete an MCP server
438
+
439
+ ### MCP Project Management (5 tools)
440
+ - **`get_mcp_project_config`** - Get MCP config for a project
441
+ - **`update_mcp_project_config`** - Update MCP config for a project
442
+ - **`get_mcp_project_installed`** - Get installed MCP clients for a project
443
+ - **`install_mcp_project`** - Install MCP for a project into a client
444
+ - **`get_mcp_project_composer_url`** - Get the MCP composer URL for a project
445
+
446
+ ### Starter & Templates (1 tool)
358
447
  - **`list_starter_projects`** - List available starter templates
359
- - **`upload_knowledge_base`** - Upload file to create/update knowledge base
360
448
 
361
449
  ### Profile & Media (2 tools)
362
450
  - **`list_profile_pictures`** - List available profile pictures
@@ -365,11 +453,72 @@ Once connected, Claude can use:
365
453
  ### Integration Tools (1 tool)
366
454
  - **`list_elevenlabs_voices`** - List ElevenLabs text-to-speech voices
367
455
 
368
- ### System & Health (3 tools)
456
+ ### System & Health (4 tools)
369
457
  - **`get_version`** - Get Langflow API version information
370
458
  - **`health_check`** - Check Langflow instance health status
459
+ - **`get_health_check`** - Get a detailed health-check report
371
460
  - **`get_logs`** - Retrieve system logs (supports streaming)
372
461
 
462
+ ### Authorization / RBAC (23 tools, Langflow 1.10.0)
463
+ - **`list_authz_roles`**, **`get_authz_role`**, **`create_authz_role`**, **`update_authz_role`**, **`delete_authz_role`** - Manage roles
464
+ - **`list_authz_role_assignments`**, **`create_authz_role_assignment`**, **`delete_authz_role_assignment`** - Manage role assignments
465
+ - **`list_authz_teams`**, **`get_authz_team`**, **`create_authz_team`**, **`update_authz_team`**, **`delete_authz_team`** - Manage teams
466
+ - **`list_authz_team_members`**, **`add_authz_team_member`**, **`remove_authz_team_member`** - Manage team members
467
+ - **`list_authz_shares`**, **`get_authz_share`**, **`create_authz_share`**, **`update_authz_share`**, **`delete_authz_share`** - Manage resource shares
468
+ - **`get_authz_audit`** - Query the authorization audit log (superuser)
469
+ - **`get_my_permissions`** - Get the caller's effective permissions
470
+
471
+ ### Memory Bases (10 tools, Langflow 1.10.0 — experimental)
472
+ - **`create_memory_base`**, **`list_memory_bases`**, **`get_memory_base`** - Manage memory bases
473
+ - **`list_memory_base_sessions`**, **`list_memory_base_messages`** - Inspect tracked sessions/messages
474
+ - **`update_memory_base`**, **`delete_memory_base`** - Update/delete a memory base
475
+ - **`flush_memory_base`**, **`check_memory_base_mismatch`**, **`regenerate_memory_base`** - Lifecycle operations
476
+
477
+ ### Knowledge Base Overhaul (7 tools, Langflow 1.10.0)
478
+ - **`test_knowledge_base_connection`** - Test a vector backend connection
479
+ - **`list_knowledge_base_connectors`** - List available ingestion connectors
480
+ - **`ingest_knowledge_base_folder`**, **`ingest_knowledge_base_connector`** - Ingest from a server folder or connector
481
+ - **`get_knowledge_base_metadata_keys`** - List distinct metadata keys/values
482
+ - **`list_knowledge_base_runs`**, **`get_knowledge_base_run`** - Inspect ingestion runs
483
+
484
+ ### Extensions & Misc (6 tools, Langflow 1.10.0)
485
+ - **`reload_extension_bundle`** - Reload an extension bundle (requires server-side flag)
486
+ - **`get_extension_events`** - Poll extension events for the current user
487
+ - **`get_agentic_file`** - Read a file from the per-user agentic sandbox
488
+ - **`reset_agentic_session`** - Reset agentic session/sandbox state
489
+ - **`get_flow_note_translations`** - Get localized note-node translations for a flow
490
+ - **`get_job_queue_metrics`** - Job-queue metrics snapshot (superuser)
491
+
492
+ > The v2 workflow runner (`run_workflow` / `workflow` action `run`) also accepts request-level
493
+ > `globals` (Langflow 1.10.0), the preferred replacement for the deprecated
494
+ > `X-LANGFLOW-GLOBAL-VAR-*` headers.
495
+
496
+ ### A2A Protocol (3 tools, Langflow 1.11.0)
497
+ - **`list_a2a_agents`** - List available A2A (Agent-to-Agent) agents
498
+ - **`get_a2a_agent_card`** - Get a flow's A2A agent card (`.well-known/agent-card.json`)
499
+ - **`invoke_a2a_jsonrpc`** - Invoke a flow via the A2A JSON-RPC endpoint (passthrough envelope)
500
+
501
+ > A2A endpoints require server-side enablement (`LANGFLOW_A2A_ENABLED`); otherwise
502
+ > requests surface as a thrown `Failed to ...` error.
503
+
504
+ ### v2 Workflow HITL & Public Execution (4 tools, Langflow 1.11.0)
505
+ - **`list_pending_workflows`** - List pending human-in-the-loop workflows (optional `flow_id` filter)
506
+ - **`get_workflow_events`** - Re-attach to a workflow job event stream by job ID
507
+ - **`resume_workflow`** - Resume a paused HITL workflow with a decision payload
508
+ - **`run_public_workflow`** - Run a public (unauthenticated-eligible) workflow
509
+
510
+ > The `get_workflow_events` and `run_public_workflow` endpoints return server-sent-event
511
+ > streams; the initial payload is captured but streaming is not incrementally surfaced.
512
+
513
+ ### External / Trusted-JWT Authentication (Langflow 1.11.0)
514
+
515
+ Langflow 1.11.0 adds external trusted-JWT / JIT-provisioning authentication. This is
516
+ controlled entirely by the Langflow **server** environment and adds **no MCP tools**:
517
+ `EXTERNAL_AUTH_ENABLED`, `EXTERNAL_AUTH_TOKEN_HEADER`/`EXTERNAL_AUTH_TOKEN_COOKIE`,
518
+ `EXTERNAL_AUTH_JWKS_URL`, `EXTERNAL_AUTH_ISSUER`/`EXTERNAL_AUTH_AUDIENCE`/`EXTERNAL_AUTH_ALGORITHMS`,
519
+ `EXTERNAL_AUTH_*_CLAIM`, and `EXTERNAL_AUTH_ACCESS_CEILING_*`. The MCP client keeps using its
520
+ API key / Bearer token as before.
521
+
373
522
  ## Example Usage
374
523
 
375
524
  ```typescript
@@ -1,7 +1,6 @@
1
- import { BuildVerticesRequest, VerticesOrderResponse, GetVertexParams, StreamVertexBuildParams } from '../../types';
1
+ import { BuildVerticesRequest, VerticesOrderResponse, StreamVertexBuildParams } from '../../types';
2
2
  export declare const mockBuildVerticesRequest: BuildVerticesRequest;
3
3
  export declare const mockVerticesOrderResponse: VerticesOrderResponse;
4
- export declare const mockGetVertexParams: GetVertexParams;
5
4
  export declare const mockVertexResponse: {
6
5
  id: string;
7
6
  vertex_id: string;
@@ -1 +1 @@
1
- {"version":3,"file":"vertices.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/vertices.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,wBAAwB,EAAE,oBAUtC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,qBAQvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAGjC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAY9B,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,uBAGzC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC"}
1
+ {"version":3,"file":"vertices.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/vertices.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,wBAAwB,EAAE,oBAUtC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,qBAQvC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAY9B,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,uBAGzC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC"}
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.mockStreamVertexResponse = exports.mockStreamVertexBuildParams = exports.mockVertexResponse = exports.mockGetVertexParams = exports.mockVerticesOrderResponse = exports.mockBuildVerticesRequest = void 0;
3
+ exports.mockStreamVertexResponse = exports.mockStreamVertexBuildParams = exports.mockVertexResponse = exports.mockVerticesOrderResponse = exports.mockBuildVerticesRequest = void 0;
4
4
  exports.mockBuildVerticesRequest = {
5
5
  data: {
6
6
  nodes: [
@@ -21,10 +21,6 @@ exports.mockVerticesOrderResponse = {
21
21
  { vertex_id: 'vertex-3', position: 2 }
22
22
  ]
23
23
  };
24
- exports.mockGetVertexParams = {
25
- flow_id: 'flow-123',
26
- vertex_id: 'vertex-1'
27
- };
28
24
  exports.mockVertexResponse = {
29
25
  id: 'vertex-1',
30
26
  vertex_id: 'vertex-1',
@@ -1 +1 @@
1
- {"version":3,"file":"vertices.js","sourceRoot":"","sources":["../../../src/__tests__/fixtures/vertices.ts"],"names":[],"mappings":";;;AAOa,QAAA,wBAAwB,GAAyB;IAC5D,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;YAC/B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;SACjC;KACF;IACD,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;CAC7B,CAAC;AAEW,QAAA,yBAAyB,GAA0B;IAC9D,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IACzC,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE;QACf,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;QACtC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;QACtC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;KACvC;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAoB;IAClD,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,UAAU;CACtB,CAAC;AAEW,QAAA,kBAAkB,GAAG;IAChC,EAAE,EAAE,UAAU;IACd,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,UAAU;IACnB,cAAc,EAAE,WAAW;IAC3B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE;IACjC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACrC,QAAQ,EAAE;QACR,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC;AAEW,QAAA,2BAA2B,GAA4B;IAClE,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,UAAU;CACtB,CAAC;AAEW,QAAA,wBAAwB,GAAG;IACtC,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,qBAAqB;IAC5B,SAAS,EAAE,KAAK;CACjB,CAAC"}
1
+ {"version":3,"file":"vertices.js","sourceRoot":"","sources":["../../../src/__tests__/fixtures/vertices.ts"],"names":[],"mappings":";;;AAMa,QAAA,wBAAwB,GAAyB;IAC5D,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;YAC/B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;SACjC;KACF;IACD,iBAAiB,EAAE,QAAQ;IAC3B,kBAAkB,EAAE,QAAQ;CAC7B,CAAC;AAEW,QAAA,yBAAyB,GAA0B;IAC9D,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IACzC,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE;QACf,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;QACtC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;QACtC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;KACvC;CACF,CAAC;AAEW,QAAA,kBAAkB,GAAG;IAChC,EAAE,EAAE,UAAU;IACd,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,UAAU;IACnB,cAAc,EAAE,WAAW;IAC3B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE;IACjC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACrC,QAAQ,EAAE;QACR,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC;AAEW,QAAA,2BAA2B,GAA4B;IAClE,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,UAAU;CACtB,CAAC;AAEW,QAAA,wBAAwB,GAAG;IACtC,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,qBAAqB;IAC5B,SAAS,EAAE,KAAK;CACjB,CAAC"}
@@ -22,6 +22,19 @@ export declare class LangflowMCPServerConsolidated {
22
22
  private handleRegistrationTool;
23
23
  private handleValidationTool;
24
24
  private handleSystemTool;
25
+ private handleFlowVersionTool;
26
+ private handleFileV2Tool;
27
+ private handleModelTool;
28
+ private handleAgenticTool;
29
+ private handleWorkflowTool;
30
+ private handleA2aTool;
31
+ private handleMcpServerTool;
32
+ private handleMcpProjectTool;
33
+ private handleTraceTool;
34
+ private handleResponseTool;
35
+ private handleAuthzTool;
36
+ private handleMemoryTool;
37
+ private handleExtensionTool;
25
38
  run(): Promise<void>;
26
39
  shutdown(): Promise<void>;
27
40
  }
@@ -1 +1 @@
1
- {"version":3,"file":"server-consolidated.d.ts","sourceRoot":"","sources":["../../src/mcp/server-consolidated.ts"],"names":[],"mappings":"AAmCA,qBAAa,6BAA6B;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA+B;;IA4D7C,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,aAAa;YAyGP,cAAc;YA0Dd,uBAAuB;YAqCvB,eAAe;YAqCf,gBAAgB;YAyChB,iBAAiB;YAsCjB,kBAAkB;YAyBlB,uBAAuB;YA4BvB,cAAc;YA6Cd,iBAAiB;YAiDjB,cAAc;YAgCd,cAAc;YAsCd,eAAe;YA4Cf,sBAAsB;YAetB,oBAAoB;YAepB,gBAAgB;IAiCxB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}
1
+ {"version":3,"file":"server-consolidated.d.ts","sourceRoot":"","sources":["../../src/mcp/server-consolidated.ts"],"names":[],"mappings":"AAgDA,qBAAa,6BAA6B;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA+B;;IA4D7C,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,aAAa;YAmIP,cAAc;YAuEd,uBAAuB;YAqCvB,eAAe;YAiCf,gBAAgB;YAyChB,iBAAiB;YAsCjB,kBAAkB;YA6BlB,uBAAuB;YA+FvB,cAAc;YA6Cd,iBAAiB;YA2FjB,cAAc;YAiCd,cAAc;YA0Cd,eAAe;YA2Df,sBAAsB;YAetB,oBAAoB;YAepB,gBAAgB;YAgDhB,qBAAqB;YA4CrB,gBAAgB;YA8ChB,eAAe;YAmEf,iBAAiB;YAkCjB,kBAAkB;YA0ClB,aAAa;YAoBb,mBAAmB;YA6BnB,oBAAoB;YAoCpB,eAAe;YAwBf,kBAAkB;YAYlB,eAAe;YAoHf,gBAAgB;YAsDhB,mBAAmB;IAiB3B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}