CLI Overview

​

Usage

automagik-tools [OPTIONS] COMMAND [ARGS]...

uvx automagik-tools [COMMAND]

​

Commands

• list - List all available tools
• tool - Serve a specific tool
• hub - Serve all tools on a single server with path-based routing
• openapi - Serve a tool directly from an OpenAPI specification URL
• info - Show detailed information about a tool
• create-tool - Create a new MCP tool from an OpenAPI specification
• mcp-config - Generate MCP configuration for a tool to use in Cursor or Claude
• version - Show version information

​

Common Patterns

​

Run tool locally (stdio)

uvx automagik-tools tool genie

​

Run tool for team (SSE)

uvx automagik-tools tool genie -t sse --port 8000 --host 0.0.0.0

​

Run all tools via hub

uvx automagik-tools hub --transport sse --port 8884

​

Convert OpenAPI to tool

uvx automagik-tools openapi https://api.example.com/openapi.json

​

Generate MCP config

uvx automagik-tools mcp-config genie --format cursor

​

Environment Variables

​

Transport and Networking

• HOST - Default host (default: localhost)
• PORT - Default port
• AUTOMAGIK_TOOLS_HOST - Host override
• AUTOMAGIK_TOOLS_SSE_PORT - SSE port override

​

Logging

• LOG_LEVEL - Logging level (DEBUG, INFO, WARNING, ERROR)
• LOG_FOLDER - Log output directory

​

Global Options

--help                  Show help message
--install-completion    Install shell completion
--show-completion       Show completion script

​

Exit Codes

​

Examples

​

List all tools

uvx automagik-tools list

​

Serve Genie with stdio

uvx automagik-tools tool genie --transport stdio

​

Serve Genie with SSE

uvx automagik-tools tool genie -t sse --port 8000

​

Start hub with all tools

uvx automagik-tools hub -t sse --port 8884

​

Convert API to MCP tool

uvx automagik-tools openapi https://api.github.com/openapi.json --api-key ghp_token

​

Get tool information

uvx automagik-tools info genie

​

Generate MCP configuration

uvx automagik-tools mcp-config genie --format cursor

​

Show version

uvx automagik-tools version

​

Next Steps