Tealfabric MCP Server for Cursor

MCP (Model Context Protocol) server that connects Cursor IDE to the Tealfabric platform. The model in Cursor can list webapps and processes, publish webapps, get/update process steps, execute processes, and upload/manage documents (package files for 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)

Install

cd cursor-mcp-tealfabric
npm install
npm run build

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).

3. 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 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_list_webapps	List webapps (optional: search, limit)
tealfabric_get_webapp	Get one webapp by ID (optional version)
tealfabric_create_webapp	Create a new webapp
tealfabric_update_webapp	Update webapp (e.g. page_content, name)
tealfabric_publish_webapp	Publish 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 (process flow)
tealfabric_update_process	Update an existing process
tealfabric_create_process_step	Create a new step in a process flow
tealfabric_update_process_step	Update an existing process step
tealfabric_list_documents	List documents in a directory
tealfabric_get_document_metadata	Get file metadata
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

• Developer guide (setup, tools, API mapping, extending): docs/DEVELOPER.md
• Tealfabric platform docs (WebApps, ProcessFlow, APIs): https://tealfabric.io/docs

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