Craft Server

A lightweight MCP (Model Context Protocol) server providing read access to craft.io.

Installation

npm install
npm run build

Configuration

Set the following environment variables:

export CRAFT_API_KEY="your-api-key"
export CRAFT_WORKSPACE_ID="your-workspace-id"
export CRAFT_ACCOUNT_ID="your-account-id"
export CRAFT_PORTAL_ID="your-portal-id"        # optional

• CRAFT_API_KEY: Your craft.io API key
• CRAFT_WORKSPACE_ID: The workspace ID (used for /workspace/{id}/items endpoint)
• CRAFT_ACCOUNT_ID: The account ID (used for /workspaces/{id} endpoint to list workspaces)

Usage

With Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "craft": {
      "command": "node",
      "args": ["/path/to/craft_mcp/dist/index.js"],
      "env": {
        "CRAFT_API_KEY": "your-api-key",
        "CRAFT_WORKSPACE_ID": "your-workspace-id",
        "CRAFT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Standalone

npm start

Available Tools

Tool	Description
craft_ping	Test connectivity to craft.io API
craft_get_workspace	Get workspace details
craft_get_items	Get items (products, features, etc.) from workspace
craft_get_item	Get a specific item by ID (e.g., UPS-1234)

Development

# Watch mode for development
npm run dev

# Build
npm run build

License

MIT