Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KIRO_MCP_CLI_PATH | No | Path to kiro-cli executable | kiro-cli |
| KIRO_MCP_TASK_TTL | No | Task result TTL in seconds | 3600 |
| KIRO_MCP_LOG_LEVEL | No | Logging level | INFO |
| KIRO_MCP_POOL_SIZE | No | Process pool size | 5 |
| KIRO_MCP_LOG_RESPONSE | No | Log full CLI responses for debugging | true |
| KIRO_MCP_MAX_SESSIONS | No | Maximum concurrent sessions | 10 |
| KIRO_MCP_POOL_ENABLED | No | Enable process pooling | true |
| KIRO_MCP_DEFAULT_AGENT | No | Default agent to use | kiro_default |
| KIRO_MCP_DEFAULT_MODEL | No | Default AI model for kiro-cli | claude-opus-4.5 |
| KIRO_MCP_POOL_MAX_USES | No | Max uses per process before recycling | 100 |
| KIRO_MCP_POOL_IDLE_TIME | No | Process idle time before recycling in seconds | 300 |
| KIRO_MCP_COMMAND_TIMEOUT | No | Command timeout in seconds - IDE-optimized | 30 |
| KIRO_MCP_MAX_ASYNC_TASKS | No | Maximum concurrent async tasks | 100 |
| KIRO_MCP_SESSION_TIMEOUT | No | Session idle timeout in seconds | 300 |
| KIRO_MCP_CLEANUP_INTERVAL | No | Session cleanup check interval in seconds | 30 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kiro_chat | Send a chat message to kiro-cli and get AI response |
| kiro_session_create | Create a new kiro-cli session. If working_directory is not provided or does not exist, the current directory will be used. |
| kiro_session_list | List all active kiro-cli sessions |
| kiro_session_switch | Switch to a specific session |
| kiro_session_end | End a kiro-cli session |
| kiro_command | Execute a kiro-cli command (e.g., /mcp, /help) |
| kiro_agents_list | List available custom agents |
| kiro_history | Get conversation history for a session |
| kiro_history_clear | Clear conversation history for a session |
| kiro_chat_async | Start an async chat task for streaming-like experience. Use kiro_task_status to poll for results. |
| kiro_task_status | Get status and partial results of an async task. Use for polling streaming results. |
| kiro_task_cancel | Cancel a running async task |
| kiro_task_list | List active async tasks |
| kiro_pool_stats | Get process pool statistics for performance monitoring |
| kiro_session_clear | Clear kiro-cli session history in working directory (deletes .kiro/session.json) |
| kiro_session_save | Save current kiro-cli session to a file using /save command |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Active Sessions | List of all active kiro-cli sessions |
| Available Agents | List of configured custom agents |
| Server Configuration | Current server configuration (read-only) |