ClocknextHelp
DocumentationAPI ReferenceMCP Tools
Dashboard
OverviewAgent pluginMCP serverAgent skills

MCP Tools

Agent skills

Give your agent the Clocknext onboarding playbook.

Agent Skills are folders of instructions, scripts, and resources that agents can discover and load on demand to do work more reliably. They solve the problem of giving agents procedural knowledge and product-specific context they wouldn't otherwise have. Clocknext ships one — the guided playbook that drives the MCP tools through a full billing setup.

The skill drives the tools

On its own the skill has nothing to call. Install the MCP server too (or use the plugin, which bundles both) so the steps in the playbook have tools to run.

Installing skills

Install with npx skills — one command, across Claude Code, Cursor, Codex, Windsurf, Gemini, Antigravity, VS Code, and ~20 other agents. Target your agent with --agent so it lands where that agent looks:

# user-wide (all projects), for a specific agent:
npx skills add Clocknext/clocknext-mcp --global --agent claude-code

# …or this project only — run this from your project root:
cd path/to/your/project
npx skills add Clocknext/clocknext-mcp --agent claude-code

Swap claude-code for cursor, codex, windsurf, … (or * for every detected agent). Skills install at project scope by default; pass --global to install across all your projects. npx skills list shows what's installed; npx skills remove clocknext-onboarding removes it. Restart the agent after installing — most load skills at startup.

Claude Code, read this

Claude Code only loads skills from ~/.claude/skills/, .claude/skills/, or a plugin — not the CLI's default .agents/skills/ folder. So pass --agent claude-code (as above). A bare npx skills add … puts it where Claude Code will never see it. Simplest of all for Claude Code: use the plugin — it registers the skill natively and wires the MCP in one step.

Available skills

clocknext-onboarding

Use when setting up or running Clocknext usage-based billing. The skill guides a product end-to-end: detect and enable the models it uses, create entitlements (credits / outcomes / units) and a plan, meter every billable call in the codebase, and prove it with a dummy customer and live signals. It is fully human-in-the-loop and UI-first for catalogue setup (the MCP tools are the fallback), with a hard stop before anything that spends real money.

npx skills add Clocknext/clocknext-mcp --skill clocknext-onboarding --agent claude-code

Install it with the MCP server

You can install the skill together with the MCP server in one step using the Clocknext plugin (Claude Code). On other agents, install the skill (above) and the MCP server separately — the skill drives the tools, so you want both.

Manual install

Learn more

  • Clocknext MCP server — the tools the skill calls
  • Agent plugin — skill + MCP server in one step
  • clocknext-mcp on GitHub — the source for the server and skill
  • skills.sh — the skills CLI and directory

MCP server

Connect your AI tools to Clocknext using MCP.

On this page

Installing skillsAvailable skillsclocknext-onboardingInstall it with the MCP serverManual installLearn more