@ycadence/mcp

A Model Context Protocol server for YCadence. It lets an AI agent list, read, create and update work items, and read states and cycles. It speaks JSON-RPC over stdio.

Tools

| Tool | What it does | |---|---| | ycadence_list_work_items | List work items in a project, optionally filtered | | ycadence_get_work_item | Read one work item | | ycadence_create_work_item | Create a work item | | ycadence_update_work_item | Change a work item's state, priority, title and so on | | ycadence_list_states | The project's workflow states | | ycadence_list_cycles | The project's cycles |

The older devpulse_* names are still registered, as deprecated aliases, for one release.

Use with Claude Code

claude mcp add ycadence \
  -e YCADENCE_URL=https://ycadence.example.com \
  -e YCADENCE_API_KEY=yc_live_p_... \
  -- npx -y @ycadence/mcp

Use with any MCP client

{
  "mcpServers": {
    "ycadence": {
      "command": "npx",
      "args": ["-y", "@ycadence/mcp"],
      "env": {
        "YCADENCE_URL": "https://ycadence.example.com",
        "YCADENCE_API_KEY": "yc_live_p_..."
      }
    }
  }
}

The package installs two commands that behave the same: ycadence-mcp, and devpulse-mcp, the name from before the rename. For an instance behind Google IAP, also set YCADENCE_IDENTITY_TOKEN. It lasts about an hour, so restart the server when it expires. When a YCADENCE_* variable is unset, the server reads the older DEVPULSE_* name instead.

Requires Node 18 or later. The package is self-contained and installs no other packages.

If npm is unavailable

Each release is mirrored to GitHub Packages when the npm publish fails, as @yarlisaisolutions/ycadence-mcp. It needs a GitHub token with read:packages:

# ~/.npmrc
@yarlisaisolutions:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

npx -y @yarlisaisolutions/ycadence-mcp

License

Apache-2.0