npm package: @iflow-mcp/glifxyz-glif-mcp-server
Description: Run AI magic workflows from glif.app
Author: glifxyz
Latest version: 0.9.11

# 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

## Setup

### Running via npx (recommended)

If you have nodejs installed, you can run our [@glifxyz/glif-mcp-server](https://www.npmjs.com/package/@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`

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

### Running from a local checkout

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

Then configure your MCP client:

   ```json
   {
     "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:

```json
{
  "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

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

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

### Debugging

```bash
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)

## License

MIT - see [LICENSE](LICENSE)