Quarkie MCP

MCP bridge for Quarkie -- manage AI agents, team members, absences, and more from Claude, Cursor, or any MCP-compatible client.

This package is a lightweight stdio-to-HTTP proxy. It forwards JSON-RPC messages between your MCP client and the Quarkie server, injecting your API key automatically. Zero dependencies, zero config files.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "quarkie": {
      "command": "npx",
      "args": ["-y", "@workisgood/quarkie-mcp"],
      "env": {
        "QUARKIE_API_KEY": "your-personal-access-token"
      }
    }
  }
}

Claude Code

claude mcp add quarkie -- npx -y @workisgood/quarkie-mcp

Then set the environment variable before running Claude Code:

export QUARKIE_API_KEY="your-personal-access-token"

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "quarkie": {
      "command": "npx",
      "args": ["-y", "@workisgood/quarkie-mcp"],
      "env": {
        "QUARKIE_API_KEY": "your-personal-access-token"
      }
    }
  }
}

Smithery

npx -y @smithery/cli install @workisgood/quarkie-mcp --client claude

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | QUARKIE_API_KEY | Yes | Your Personal Access Token | | QUARKIE_URL | No | API base URL (defaults to Quarkie Cloud) |

Available Tools

The tools are defined on the Quarkie server and delivered dynamically via MCP. The current set includes:

| Tool | Description | |------|-------------| | quarkie_list_agents | List all registered agents | | quarkie_get_agent | Get agent details | | quarkie_create_agent | Register a new agent (returns API key) | | quarkie_toggle_agent | Enable or disable an agent | | quarkie_delete_agent | Delete an agent | | quarkie_regenerate_key | Revoke all keys and generate a new one | | quarkie_read_config | Read agent config file (SOUL.md, IDENTITY.md, etc.) | | quarkie_update_config | Update agent config file | | quarkie_dispatch | Send an instruction to an agent | | quarkie_list_admins | List org-wide agent admins | | quarkie_update_admins | Set agent admins | | quarkie_list_managers | List per-agent managers | | quarkie_update_managers | Set per-agent managers | | quarkie_list_team | List all human team members | | quarkie_list_absences | List all absences (calendar view) | | quarkie_my_vacation_info | Get vacation balance for an employee | | quarkie_schedule_absence | Request time off | | quarkie_approve_absence | Approve or reject an absence request | | quarkie_vacation_requests_summary | Org-wide vacation requests overview | | quarkie_absence_types | List available absence types |

Getting an API Key

1. Sign in to Quarkie
2. Go to Settings > Personal Access Tokens
3. Create a new token and copy it
4. Set it as the QUARKIE_API_KEY environment variable

How It Works

This package runs as a stdio MCP server. It reads JSON-RPC messages from stdin, forwards them to the Quarkie API over HTTP (with your API key in the X-API-Key header), and writes responses back to stdout. It supports both plain JSON and Server-Sent Events responses from the server.

No SDK dependencies are needed -- the bridge uses only Node.js built-in modules.

License

MIT