glif-mcp-server

MCP server for running AI workflows from glif.app.

For more info check out https://glif.app or join our Discord server: https://discord.gg/glif

Features

• Run workflows with inputs
• Get detailed information about workflows, runs, and users
• Search and discover workflows
• Browse and load agents

Tools

Core Tools

• run_workflow - Run a workflow with the specified ID and inputs
• workflow_info - Get detailed information about a workflow

Discovery Tools (enabled by default)

• list_featured_workflows - Get a curated list of featured workflows
• search_workflows - Search for workflows by name or description
• my_workflows - Get a list of your workflows
• my_user_info - Get detailed information about your account

Agent Tools (disabled by default, enable with AGENT_TOOLS=true)

• list_agents - Get a list of agents with optional filtering
• load_agent - Load an agent and get its details including personality and workflows

Resources

• glif://{id} - Get workflow metadata
• glifRun://{id} - Get run details
• glifUser://{id} - Get user profile

Development

npm install
npm run build
npm run dev     # auto-rebuild
npm run test    # run tests

Debugging

npm run inspector

Releasing

1. Edit package.json and src/index.ts and bump the version
2. Run npm install to update lockfile
3. Commit and push to main
4. Run npm run release (requires gh CLI)

Setup

Running via npx (recommended)

If you have nodejs installed, you can run our @glifxyz/glif-mcp-server package via npx:

1. Get your API token from https://glif.app/settings/api-tokens

2. Add the server in your Claude Desktop config file. On macOS this is: ~/Library/Application Support/Claude/claude_desktop_config.json

   Copy

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

Running from a local checkout

git clone https://github.com/glifxyz/glif-mcp-server
cd glif-mcp-server
npm install
npm run build

Then configure your MCP client:

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

You can also specify workflow IDs (comma-separated) which will be loaded automatically:

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

Configuration

Environment variables:

• GLIF_API_TOKEN - Required. Your API token from https://glif.app/settings/api-tokens
• GLIF_IDS - Optional. Comma-separated workflow IDs to load as tools automatically
• IGNORE_DISCOVERY_TOOLS - Set to true to disable discovery tools
• AGENT_TOOLS - Set to true to enable agent tools

License

MIT - see LICENSE