# Craft MCP Server
A lightweight MCP (Model Context Protocol) server providing read access to [craft.io](https://craft.io).
## Installation
```bash
npm install
npm run build
```
## Configuration
Set the following environment variables:
```bash
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`):
```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
```bash
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
```bash
# Watch mode for development
npm run dev
# Build
npm run build
```
## License
MIT
