Skip to main content
Glama
Sign In
Tealfabric MCP Server for Cursor

Tealfabric MCP Server for Cursor

Official
by tealfabric
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Tealfabric MCP Server for Cursor

MCP (Model Context Protocol) server that connects Cursor IDE to the Tealfabric platform. The model in Cursor can manage connectors, integrations, webapps, ProcessFlow processes/steps, and documents (including text read/write and package delivery).

Prerequisites

  • Node.js 18+

  • A Tealfabric API key (create one in Tealfabric: User settings → API Keys, or POST /api/v1/api-keys when logged in)

  • Key scopes as needed: connectors.read|write, integrations.read|write|execute|delete, webapps.read|write, processflow.read|write, documents.read|write

Related MCP server: Azure DevOps MCP Server

Install

cd cursor-mcp-tealfabric
npm install
npm run build

Upgrading from 0.1.x? Read docs/RELEASE_NOTES_0.2.0.md and docs/MIGRATING.md — publish, create-webapp, list-webapps, and test-connector inputs changed.

Cursor setup

  1. Create an API key in Tealfabric (if you don’t have one).

  2. Add the MCP server in Cursor:

    • Cursor Settings (Cmd+, / Ctrl+,) → Tools & MCP → Add new MCP server

    • Or create/edit .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "tealfabric": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/cursor-mcp-tealfabric/dist/index.js"],
      "env": {
        "TEALFABRIC_API_KEY": "YOUR_API_KEY_HERE",
        "TEALFABRIC_API_URL": "https://tealfabric.io"
      }
    }
  }
}

Replace:

  • YOUR_API_KEY_HERE with your Tealfabric API key (e.g. tf_live_...).

  • /ABSOLUTE/PATH/TO/cursor-mcp-tealfabric/... with the real path to this repo (e.g. /Users/username/src/cursor-mcp-tealfabric/dist/index.js).

  1. Restart Cursor so it picks up the new server.

Tools exposed to Cursor

Tool

Description

tealfabric_list_connectors

List connectors (optional action: get, parameters)

tealfabric_test_connector

Test connector (connector_id + optional configuration)

tealfabric_get_connector_oauth2_required

Check whether connector requires OAuth2

tealfabric_list_integrations

List integrations or query by action/filter

tealfabric_create_integration

Create a new integration

tealfabric_update_integration

Update an existing integration

tealfabric_execute_integration

Execute an integration (optional async/data)

tealfabric_delete_integration

Delete an integration

tealfabric_list_webapps

List webapps (page / items_per_page, filters)

tealfabric_get_webapp

Get one webapp by ID (optional version)

tealfabric_create_webapp

Create webapp (name, type, page_content, webapp_user_id)

tealfabric_update_webapp

Update webapp (content, auth, public URI, etc.)

tealfabric_publish_webapp

Publish a webapp version (requires version)

tealfabric_unpublish_webapp

Unpublish a webapp

tealfabric_create_webapp_version

Create a new unpublished webapp version

tealfabric_delete_webapp

Delete a webapp

tealfabric_list_processes

List ProcessFlow processes

tealfabric_get_process

Get one process by ID

tealfabric_list_process_steps

List steps of a process

tealfabric_get_process_step

Get one process step by step_id

tealfabric_execute_process

Execute a process (optional input)

tealfabric_create_process

Create a new process

tealfabric_update_process

Update an existing process

tealfabric_delete_process

Hard-delete a process

tealfabric_retire_process

Soft-retire a process (<retired> + inactive)

tealfabric_create_process_step

Create a new step (name/step_name, optional language)

tealfabric_update_process_step

Update an existing process step

tealfabric_delete_process_step

Delete a process step

tealfabric_list_documents

List documents in a directory

tealfabric_list_document_tree

List documents as a tree

tealfabric_get_document_metadata

Get file metadata

tealfabric_read_document_text

Read UTF-8 text document

tealfabric_write_document_text

Write UTF-8 text document

tealfabric_download_document

Download a file (returns base64 payload)

tealfabric_upload_document

Upload a file (e.g. built package)

tealfabric_move_document

Move or rename file/directory

tealfabric_delete_document

Delete file or directory

Environment variables

Variable

Required

Default

Description

TEALFABRIC_API_KEY

Yes

—

Tealfabric API key (X-API-Key / Bearer)

TEALFABRIC_API_URL

No

https://tealfabric.io

Tealfabric base URL

Security

  • Do not commit .cursor/mcp.json if it contains your real API key. Use .cursor/mcp.json.example (without the key) and add mcp.json to .gitignore, or use Cursor’s UI so the key stays local.

  • API keys are scoped to your user/tenant in Tealfabric; create keys with minimal required scopes if your platform supports it.

Documentation

Related projects

Tealfabric exposes the same MCP capabilities across different host environments. Each repo ships the appropriate packaging and setup for its platform:

Host

Repository

Cursor (this repository)

tealfabric/cursor-mcp-tealfabric

Claude (Claude Code and compatible MCP clients)

tealfabric/claude-mcp-tealfabric

Lovable

tealfabric/lovable-mcp-tealfabric

Available Tools

37 tools
tealfabric_create_integrationD

Create a new integration.

Inputs: name (required), type (required), status, is_active, +5 more.

tealfabric_create_processC

Create a new Tealfabric process (process flow). Returns the new process_id.

Inputs: name (required), type, status, category, +5 more.

tealfabric_create_process_stepC

Create a new process step in a process flow. Returns the new step_id.

Inputs: process_id (required), name, language, sequence, +9 more.

tealfabric_create_webappC

Create a new Tealfabric webapp (unpublished by default). Requires name, type, page_content, and webapp_user_id.

Inputs: name (required), type (required), page_content (required), webapp_user_id (required), +18 more.

tealfabric_create_webapp_versionA

Create a new unpublished version of a webapp (copies latest version).

Inputs: webapp_id (required).

tealfabric_delete_documentC

Delete a file or directory from Tealfabric documents storage.

Inputs: path (required), tenant_id.

tealfabric_delete_integrationC

Delete an integration by ID.

Inputs: integration_id (required).

tealfabric_delete_processA

Hard-delete a Tealfabric process by ID.

Inputs: process_id (required).

tealfabric_delete_process_stepC

Delete a process step by step_id.

Inputs: step_id (required).

tealfabric_delete_webappC

Delete a Tealfabric webapp by ID.

Inputs: webapp_id (required).

tealfabric_download_documentA

Download a document/file from Tealfabric documents storage. Returns file content as base64 for binary-safe transfer.

Inputs: file_path (required), tenant_id.

tealfabric_execute_integrationC

Execute an integration (optionally async) with optional call data.

Inputs: integration_id (required), data, async.

tealfabric_execute_processC

Execute a Tealfabric process with optional input.

Inputs: process_id (required), input.

tealfabric_get_connector_oauth2_requiredA

Check whether a connector requires OAuth2 authentication.

Inputs: connector_id (required).

tealfabric_get_document_metadataC

Get metadata for a document/file in Tealfabric documents storage.

Inputs: file_path (required), tenant_id.

tealfabric_get_processB

Get a single Tealfabric process by ID.

Inputs: process_id (required).

tealfabric_get_process_stepB

Get a single process step by step_id.

Inputs: step_id (required).

tealfabric_get_webappA

Get a single Tealfabric webapp by ID. Optionally request a specific version.

Inputs: webapp_id (required), version.

tealfabric_list_connectorsB

List Tealfabric connectors, get a specific connector, or fetch connector parameters.

Inputs: action, connector_id.

tealfabric_list_documentsB

List documents/files in a Tealfabric documents directory. Use for browsing package files.

Inputs: path, tenant_id.

tealfabric_list_document_treeC

List a Tealfabric documents directory as a tree (action=tree).

Inputs: path, max_depth, tenant_id.

tealfabric_list_integrationsC

List integrations or query integration details/status/statistics/execution history via action filters.

Inputs: page, type, limit, action, +8 more.

tealfabric_list_processesB

List Tealfabric ProcessFlow processes for the authenticated tenant.

Inputs: no named parameters.

tealfabric_list_process_stepsC

List process steps for a given process.

Inputs: process_id (required).

tealfabric_list_webappsC

List Tealfabric webapps for the authenticated tenant.

Inputs: page, type, search, sort_by, +4 more.

tealfabric_move_documentB

Move or rename a file/directory in Tealfabric documents storage. Use to update package paths or reorganize.

Inputs: new_path (required), old_path (required), tenant_id.

tealfabric_publish_webappB

Publish a Tealfabric webapp version (make that version live).

Inputs: version (required), webapp_id (required).

tealfabric_read_document_textB

Read a UTF-8 text document from Tealfabric documents storage (action=read-text).

Inputs: file_path (required), tenant_id.

tealfabric_retire_processA

Soft-retire a process (sets status inactive and prefixes name with ). Prefer this over hard delete when preserving history.

Inputs: process_id (required).

tealfabric_test_connectorC

Test a connector configuration against the Tealfabric connectors test endpoint.

Inputs: connector_id (required), configuration.

tealfabric_unpublish_webappB

Unpublish a Tealfabric webapp (take it offline).

Inputs: webapp_id (required).

tealfabric_update_integrationD

Update an existing integration.

Inputs: integration_id (required), name, type, status, +6 more.

tealfabric_update_processC

Update an existing Tealfabric process (process flow).

Inputs: process_id (required), name, type, status, +6 more.

tealfabric_update_process_stepC

Update an existing process step in a process flow.

Inputs: step_id (required), name, language, sequence, +11 more.

tealfabric_update_webappC

Update an existing Tealfabric webapp (content, auth, public URI, etc.).

Inputs: webapp_id (required), name, version, custom_js, +18 more.

tealfabric_upload_documentB

Upload a file to Tealfabric documents storage. Use to publish built package files for delivery. The file is stored in destination_path using the uploaded file's name.

Inputs: file_path (required), destination_path (required), tenant_id.

tealfabric_write_document_textB

Write UTF-8 text to a Tealfabric documents path (action=write-text; creates a backup).

Inputs: content (required), file_path (required), encoding, tenant_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    C2.8/5.0

    Scored across 37 tools

    Disambiguation4/5

    Most tools target a distinct resource+action across five clear domains (connectors, integrations, webapps, processes, documents), and delete vs retire process is explicitly differentiated. However, tealfabric_list_documents vs tealfabric_list_document_tree overlap heavily (the latter is just an action variant), and tealfabric_update_webapp vs tealfabric_create_webapp_version vs tealfabric_publish_webapp have fuzzy boundaries around when to use which.

    Naming Consistency5/5

    Every tool follows the same tealfabric_verb_noun snake_case pattern, with a stable verb vocabulary (list, get, create, update, delete, execute, publish, unpublish, move, read/write/download/upload). Compound nouns like process_step and webapp_version are used consistently rather than introducing new conventions.

    Tool Count2/5

    37 tools is well past the 25+ threshold and is more surface than an agent can reliably route among in one context. While five resource domains partially justify the volume, consolidation is clearly possible (e.g. list_documents/list_document_tree as one tool with an action flag, like list_integrations already does).

    Completeness4/5

    Integrations, webapps, processes/steps, and documents each have near-full lifecycle coverage, including versioning, publish/unpublish, soft-retire, and binary-safe upload/download. Minor gaps remain: connectors are read/test only with no create/update, and there is no way to list or fetch individual webapp versions.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Fledge MCP Server

      Krupalp525
      A
      license
      Not graded
      quality
      D
      maintenance
      Connects Fledge functionality to Cursor AI, allowing interaction with Fledge instances via natural language commands.
      MIT

    • Azure DevOps MCP Server

      dhippley
      A
      license
      Not graded
      quality
      F
      maintenance
      Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps task management.
      1
      MIT

    • TeamCity MCP Server

      hex
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables management of TeamCity CI/CD operations through natural language commands, including builds, projects, tests, artifacts, and more.
      15 npm
      MIT