Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
npm install
npm run build2
Register it in Claude Code
claude mcp add -e "CRAFT_API_KEY=${CRAFT_API_KEY}" -e "CRAFT_WORKSPACE_ID=${CRAFT_WORKSPACE_ID}" -e "CRAFT_ACCOUNT_ID=${CRAFT_ACCOUNT_ID}" craft-mcp -- node /path/to/craft_mcp/dist/index.jsReplace any placeholder paths in the command with the real path on your machine.
Required:
CRAFT_API_KEYCRAFT_WORKSPACE_IDCRAFT_ACCOUNT_ID+ 1 optional3
Make your agent remember this setup
craft-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Read access to craft.io workspaces
- Retrieve lists of products and features
- Fetch specific item details by ID
- Verify API connectivity
Tools 4
craft_pingTest connectivity to craft.io APIcraft_get_workspaceGet workspace detailscraft_get_itemsGet items (products, features, etc.) from workspacecraft_get_itemGet a specific item by ID (e.g., UPS-1234)Environment Variables
CRAFT_API_KEYrequiredYour craft.io API keyCRAFT_WORKSPACE_IDrequiredThe workspace ID used for items endpointCRAFT_ACCOUNT_IDrequiredThe account ID used for workspaces endpointCRAFT_PORTAL_IDOptional portal IDTry it
→Check if the connection to my craft.io workspace is working.
→List all the items currently in my workspace.
→Retrieve the details for the item with ID UPS-1234.
→Get the details of my current craft.io workspace.
Original README from upstackjade/craft_mcp
Craft MCP 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}/itemsendpoint) - 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