MCP#

Start MCP server for AI tool integration.

Synopsis#

smif mcp [options]

Description#

The mcp command starts a Model Context Protocol (MCP) server that exposes Semifold tools to AI assistants. This enables AI tools to interact with Semifold programmatically.

Options#

MCP Tools#

The Semifold MCP server provides the following tools:

get_tags#

Get all available tags from the Semifold configuration.

Returns: JSON object mapping tag keys to descriptions

{
  "feat": "New Features",
  "fix": "Bug Fixes",
  "chore": "Chores"
}

get_packages#

Get all packages from the Semifold configuration with their paths and resolvers.

Returns: JSON object with package details

{
  "semifold": {
    "path": "crates/semifold",
    "resolver": "Rust"
  },
  "my-library": {
    "path": "packages/my-library",
    "resolver": "Nodejs"
  }
}

create_changeset#

Create a new changeset programmatically.

Parameters:

Examples#

Start MCP Server#

smif mcp

Start in Specific Directory#

smif mcp --current-dir /path/to/project

MCP Client Configuration#

The server communicates over stdio. Configure your MCP client to spawn smif mcp as a subprocess.

Claude Code / Claude Desktop#

Add to your Claude config file:

{
  "mcpServers": {
    "semifold": {
      "command": "smif",
      "args": ["mcp"]
    }
  }
}

OpenCode#

Add to your OpenCode config file (~/.config/opencode/opencode.json or ./opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "semifold": {
      "type": "local",
      "command": ["smif", "mcp"],
      "enabled": true
    }
  }
}

Other MCP Clients#

The server communicates over stdio. Configure your MCP client to spawn smif mcp as a subprocess.

Use Cases#

• AI-assisted changeset creation
• Automated release management
• Integration with AI code review tools

Requirements#

• Semifold must be initialized in the project

See Also#

• Commit Command - Manual changeset creation
• Configuration Reference