Craft

Provides read access to craft.io data via MCP endpoints for workspaces, items, and item details.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run Craft MCP Server to expose read access to craft.io data through a lightweight MCP interface. It lets your MCP clients query workspaces, items, and item details from Craft, enabling seamless integration with your tooling and workflows.

How to use

You will connect your MCP client to Craft MCP Server to fetch data from Craft. Use the MCP client’s standard workflow to list workspaces, retrieve workspace items, and query specific items by ID. Two common ways to run and connect are available: run the server locally in stdio mode during development, or configure a Claude Code-style MCP setting to start the server as a separate Node process.

How to install

Prerequisites: you must have Node.js installed on your system. A modern Node.js runtime (LTS) is recommended.

Install dependencies and build the server.

Then start the server.

Additional sections

Configuration and usage details are provided through environment variables and the available startup options.

Security: protect your API key and workspace identifiers. Do not expose sensitive credentials in shared environments.

Examples show how to wire the server with a client and how to run the server in different modes. If you need a quick start, follow the explicit startup commands and environment variable setups shown below.

Available tools

craft_ping

Test connectivity to the Craft API and ensure the MCP server can reach craft.io.

craft_get_workspace

Retrieve details for a specific workspace to confirm structure and metadata.

craft_get_items

Fetch items (products, features, etc.) from a workspace to build reviews or catalogs.

craft_get_item

Retrieve a single item by its ID (for example UPS-1234) to inspect its fields and relationships.