mcp-server

@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