Tealfabric MCP Server for Cursor

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

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