ucm-mcp-server/README.md

Universal Context Manager MCP Server - AI-native artifact management

# UCM MCP Server

Universal Context Manager (UCM) Model Context Protocol (MCP) server for AI-native package management.

Get your auth token from https://ucm.utaba.ai

## Configuration

- `--auth-token <token>` (required): Authentication token in format `{authorid}:{apikey}`

## Available MCP Tools

The server provides 11 MCP tools following the `ucm_` naming convention:

### System Tools
- `ucm_health_check` - Check MCP server and UCM API connectivity
- `ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)

### Discovery Tools
- `ucm_get_author_index` - Generate dynamic markdown index for an author
- `ucm_list_repositories` - List all repositories for an author
- `ucm_list_artifacts` - Browse the 4-level hierarchy

### Artifact Management
- `ucm_get_artifact` - Retrieve artifact content with auto-chunking
- `ucm_get_chunk` - Get chunks of large responses
- `ucm_publish_artifact` - Create/update artifacts
- `ucm_publish_artifact_fromfile` - File-based publishing (preferred for large files)
- `ucm_delete_artifact` - Remove artifacts
- `ucm_get_artifact_versions` - Get version history

## Usage with Claude Desktop

Add to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "ucm": {
      "command": "npx",
      "args": [
        "ucm-mcp-server",
        "--auth-token", "YOUR_AUTH_TOKEN"
      ]
    }
  }
}
```

## Usage with Claude Code

```bash
claude mcp add -s user ucm-mcp-server npx ucm-mcp-server --auth-token your-authtoken-here
```
Note: The above adds it to your user scope and will be available in all of your projects.  You can remove `-s user` for project scope.
## Documentation

For detailed documentation, visit:
- UCM Platform: https://ucm.utaba.ai
- GitHub: https://github.com/utaba/ucm-mcp-server

## License

BSD-3-Clause - See LICENSE file for details