⚒️ Forge MCP Server

MCP (Model Context Protocol) server for Forge — XferOps' project management system.

Works with Claude Code, OpenAI Codex, OpenClaw/mcporter, and any MCP-compatible consumer.

Migrated from @xferops/flower-mcp — see Migration Guide below.

Quick Start

1. Get Your API Token

1. Go to forge.xferops.dev/settings
2. Click New Token in the API Tokens section
3. Give it a descriptive name and click Create Token
4. Copy the token (it won't be shown again!)

2. Install

npm install -g @xferops/forge-mcp

Or use with npx (no install needed):

npx @xferops/forge-mcp

3. Configure Your MCP Consumer

See setup instructions below for your specific tool.

Setup Instructions

Claude Code (claude_desktop_config.json)

Add to ~/.config/claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "@xferops/forge-mcp"],
      "env": {
        "FORGE_URL": "https://forge.xferops.dev",
        "FORGE_TOKEN": "your-api-token-here"
      }
    }
  }
}

OpenClaw / mcporter

Add to ~/.mcporter/mcporter.json:

{
  "mcpServers": {
    "forge": {
      "command": "npx",
      "args": ["-y", "@xferops/forge-mcp"],
      "env": {
        "FORGE_URL": "https://forge.xferops.dev",
        "FORGE_TOKEN": "your-api-token-here"
      }
    }
  }
}

Then use with mcporter:

mcporter call forge.forge_list_teams
mcporter call forge.forge_get_project projectId=abc123
mcporter call forge.forge_search_tasks query="ADM-5"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FORGE_TOKEN | Yes | — | Your API token from forge.xferops.dev/settings | | FORGE_URL | No | https://forge.xferops.dev | API base URL | | FLOWER_TOKEN | No | — | Legacy alias for FORGE_TOKEN (deprecated) | | FLOWER_URL | No | — | Legacy alias for FORGE_URL (deprecated) | | KANBAN_TOKEN | No | — | Legacy alias for FORGE_TOKEN (deprecated) | | KANBAN_URL | No | — | Legacy alias for FORGE_URL (deprecated) |

Available Tools (26)

Health

| Tool | Description | |------|-------------| | forge_health_check | Check API connectivity and configured URL |

Teams

| Tool | Description | |------|-------------| | forge_list_teams | List all teams you belong to | | forge_create_team | Create a new team | | forge_list_team_members | List team members (get user IDs for assignment) | | forge_add_team_member | Add a user to a team by email |

Projects

| Tool | Description | |------|-------------| | forge_list_projects | List projects in a team | | forge_get_project | Get project with all columns and tasks | | forge_create_project | Create a new project | | forge_update_project | Update project name/prefix | | forge_delete_project | Delete a project |

Columns

| Tool | Description | |------|-------------| | forge_create_column | Create a column (e.g., "Backlog", "Done") | | forge_update_column | Rename a column | | forge_delete_column | Delete a column (optionally move tasks) | | forge_reorder_columns | Reorder columns |

Tasks

| Tool | Description | |------|-------------| | forge_get_task | Get a single task by ID | | forge_list_tasks | List all tasks in a project | | forge_search_tasks | Search tasks by title/description/ticket ID (e.g., "ADM-5") | | forge_create_task | Create a new task | | forge_update_task | Update task or move to different column | | forge_move_task | Move task to a different column (convenience wrapper) | | forge_delete_task | Delete a task | | forge_reorder_task | Move task to specific position within a column |

Comments

| Tool | Description | |------|-------------| | forge_list_comments | List comments on a task | | forge_create_comment | Add a comment | | forge_update_comment | Edit your comment | | forge_delete_comment | Delete your comment |

Migration Guide

Migrating from @xferops/flower-mcp?

1. Update your MCP config

- "command": "npx",
- "args": ["-y", "@xferops/flower-mcp"],
- "env": {
-   "FLOWER_URL": "https://flower.xferops.dev",
-   "FLOWER_TOKEN": "your-token"
- }
+ "command": "npx",
+ "args": ["-y", "@xferops/forge-mcp"],
+ "env": {
+   "FORGE_URL": "https://forge.xferops.dev",
+   "FORGE_TOKEN": "your-token"
+ }

2. Update tool calls

All tools are renamed from flower_* to forge_*:

- flower_search_tasks query="ADM-5"
+ forge_search_tasks query="ADM-5"

Note: FLOWER_URL / FLOWER_TOKEN env vars are still accepted as fallbacks during the transition period.

Development

git clone https://github.com/XferOps/forge-mcp.git
cd forge-mcp
npm install
npm run build

# Run locally
FORGE_TOKEN=your-token node dist/index.js

OpenClaw Skill

Install via ClawHub:

npx clawhub@latest install xferops-forge

Versioning

| Tag | Version | |-----|---------| | v2.x | Forge MCP (@xferops/forge-mcp) | | v1.x | Flower MCP (@xferops/flower-mcp) — deprecated |

Tag and release:

git tag v2.x.x && git push --tags

CI will publish to npm and ClawHub automatically.

License

MIT © XferOps