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.
- package/README.md +228 -79
- package/dist/__tests__/fixtures/vertices.d.ts +1 -2
- package/dist/__tests__/fixtures/vertices.d.ts.map +1 -1
- package/dist/__tests__/fixtures/vertices.js +1 -5
- package/dist/__tests__/fixtures/vertices.js.map +1 -1
- package/dist/mcp/server-consolidated.d.ts +13 -0
- package/dist/mcp/server-consolidated.d.ts.map +1 -1
- package/dist/mcp/server-consolidated.js +713 -44
- package/dist/mcp/server-consolidated.js.map +1 -1
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +749 -50
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/tools-consolidated.d.ts.map +1 -1
- package/dist/mcp/tools-consolidated.js +722 -43
- package/dist/mcp/tools-consolidated.js.map +1 -1
- package/dist/mcp/tools.d.ts.map +1 -1
- package/dist/mcp/tools.js +1701 -66
- package/dist/mcp/tools.js.map +1 -1
- package/dist/mcp/validation-consolidated.d.ts +681 -9
- package/dist/mcp/validation-consolidated.d.ts.map +1 -1
- package/dist/mcp/validation-consolidated.js +635 -15
- package/dist/mcp/validation-consolidated.js.map +1 -1
- package/dist/mcp/validation.d.ts +769 -11
- package/dist/mcp/validation.d.ts.map +1 -1
- package/dist/mcp/validation.js +600 -11
- package/dist/mcp/validation.js.map +1 -1
- package/dist/services/langflow-client.d.ts +133 -51
- package/dist/services/langflow-client.d.ts.map +1 -1
- package/dist/services/langflow-client.js +1102 -154
- package/dist/services/langflow-client.js.map +1 -1
- package/dist/types/index.d.ts +395 -4
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +16 -13
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
[](https://www.npmjs.com/package/langflow-mcp-server)
|
|
5
5
|
[](https://github.com/nobrainer-tech/langflow-mcp/releases)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
|
-
[](https://github.com/nobrainer-tech/langflow-mcp)
|
|
8
8
|
[](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.
|
|
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
|
-
|
|
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
|
-
|
|
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 |
|
|
25
|
-
| Consolidated |
|
|
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,
|
|
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
|
-
- `
|
|
41
|
-
- `
|
|
42
|
-
- `
|
|
43
|
-
- `
|
|
44
|
-
- `
|
|
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
|
-
- `
|
|
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**:
|
|
229
|
-
- **Consolidated mode**:
|
|
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 (
|
|
237
|
+
### Standard Mode Tools (216 tools)
|
|
232
238
|
|
|
233
|
-
### Flow Management (
|
|
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 (
|
|
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
|
-
###
|
|
246
|
-
- **`
|
|
247
|
-
- **`
|
|
248
|
-
- **`
|
|
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
|
-
###
|
|
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 (
|
|
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
|
-
###
|
|
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
|
-
|
|
284
|
-
- **`
|
|
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
|
-
###
|
|
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
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
- **`
|
|
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
|
-
###
|
|
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
|
|
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
|
-
###
|
|
344
|
-
- **`
|
|
345
|
-
- **`
|
|
346
|
-
- **`
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
- **`
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
- **`
|
|
355
|
-
- **`
|
|
356
|
-
|
|
357
|
-
### Starter & Templates (
|
|
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 (
|
|
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,
|
|
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,
|
|
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.
|
|
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":";;;
|
|
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":"
|
|
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"}
|