README.md
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
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.