home / mcp / glif mcp server

glif MCP Server

Runs glif AI workflows by loading workflows, runs, and user data; supports discovery and agent loading.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "glifxyz-glif-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@glifxyz/glif-mcp-server@latest"
      ],
      "env": {
        "GLIF_IDS": "cm2v9aiga00008vfqdiximl2m,cm2v98jk6000r11afslqvooil",
        "GLIF_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

You can run and manage AI workflows from glif.app by hosting an MCP server locally or via npx. This server loads workflows, provides rich details about runs and users, and exposes discovery and agent loading features to power your client experience.

How to use

To use the MCP server with your client, configure one or more MCP connections that load and operate workflows from glif.app. Start with the recommended npx approach to avoid local setup, then use a local build for persistent runs. Your client will be able to run workflows, fetch workflow information, search for workflows, and, if enabled, load agents.

How to install

Prerequisites: You need Node.js installed on your machine. If Node.js is not installed, download and install it from the official Node.js website.

Option A: Run via npx (recommended) set up the MCP server directly without cloning.

Option B: Build and run from a local checkout to customize or host the server yourself.

Configuration and startup examples

You can connect your MCP client to the server using one of the following configurations.

Example configurations

{
  "mcpServers": {
    "glif": {
      "command": "npx",
      "args": ["-y", "@glifxyz/glif-mcp-server@latest"],
      "env": {
        "GLIF_API_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "glif": {
      "command": "node",
      "args": ["/path/to/glif-mcp-server/build/index.js"],
      "env": {
        "GLIF_API_TOKEN": "your-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "glif": {
      "command": "node",
      "args": ["/path/to/glif-mcp/build/index.js"],
      "env": {
        "GLIF_API_TOKEN": "your-token-here",
        "GLIF_IDS": "cm2v9aiga00008vfqdiximl2m,cm2v98jk6000r11afslqvooil"
      }
    }
  }
}

Additional configuration notes

The server relies on an API token from your glif account. Keep your token secure and do not expose it in public configurations.

Development and troubleshooting

Common development tasks include installing dependencies, building, and running in development mode to watch for changes.

Available tools

run_workflow

Run a workflow by its ID with provided inputs.

workflow_info

Fetch detailed information about a workflow.

list_featured_workflows

Retrieve a curated list of featured workflows.

search_workflows

Search workflows by name or description.

my_workflows

List your own workflows.

my_user_info

Get detailed information about your user account.

list_agents

List available agents with optional filtering.

load_agent

Load an agent and view its details including personality and workflows.