@renseiai/agentfactory-mcp-server

MCP server that exposes AgentFactory fleet management capabilities to any MCP-aware client (Claude Desktop, Cursor, etc.).

Installation

npm install @renseiai/agentfactory-mcp-server

Requires a running Redis instance and the @renseiai/agentfactory-server package for session storage.

Tools

| Tool | Description | |------|-------------| | submit-task | Submit a development task to the fleet work queue | | get-task-status | Get current status of a task by session or issue ID | | list-fleet | List agents and their statuses with optional filtering | | get-cost-report | Get cost/token usage for a task or the entire fleet | | forward-prompt | Forward a follow-up prompt to a running agent session | | stop-agent | Request to stop a running agent |

Real-time fleet resources are also available via MCP resource subscriptions with notification polling.

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentfactory": {
      "command": "npx",
      "args": ["@renseiai/agentfactory-mcp-server", "--stdio"]
    }
  }
}

HTTP

Start the server on a specific port for remote access:

af-mcp-server --port 3100

CLI Flags

| Flag | Description | |------|-------------| | --stdio | Use STDIO transport (for IDE integration) | | --port <number> | Start HTTP transport on the given port | | --host <address> | Bind HTTP server to a specific address |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | REDIS_URL | Yes | Redis connection URL (e.g., redis://localhost:6379) | | MCP_AUTH_SECRET | No | API key for MCP authentication |

Related Packages

| Package | Description | |---------|-------------| | @renseiai/agentfactory | Core orchestrator | | @renseiai/agentfactory-server | Redis-backed work queue and session storage | | @renseiai/agentfactory-cli | CLI tools (worker, orchestrator) | | @renseiai/agentfactory-nextjs | Next.js webhook server |

License

MIT