MCP Tools
Agent plugin
One-step setup for Clocknext in your AI coding agent.
The Clocknext plugin gives your AI coding agent everything it needs to work
with Clocknext. It bundles the Clocknext MCP server
and the clocknext-onboarding skill so your agent
can meter usage, verify signals, and manage usage-based billing — without any
manual configuration.
Claude Code only
The plugin format is Claude Code's. On any other agent, install the MCP server and the Agent skill separately — you get the same result, just in two steps.
Quick installation
Add the marketplace, then install the plugin — two commands inside Claude Code:
/plugin marketplace add Clocknext/clocknext-mcp
/plugin install clocknext@clocknextClaude Code prompts for your Clocknext API key at install (stored securely), runs
the bundled server, and auto-discovers the skill from the plugin's skills/
folder. No env vars, nothing to build.
Why use the plugin?
Plugins for AI coding agents are packages of agent extensions. A single plugin can bundle any combination of:
- MCP servers — external tool integrations that let your agent interact with services like Clocknext
- Skills — procedural knowledge and context your agent loads on demand to work more accurately
- Hooks — event handlers that run at agent lifecycle points
- Agents — specialized sub-agents with specific personas and tool configurations
- Slash commands — custom commands you can invoke directly in chat
Bundling the MCP server and the onboarding skill into a single plugin means you can set both up in one step — and Claude Code wires your API key for you.
What's included
Clocknext MCP server
The Clocknext MCP server connects your AI coding agent directly to your Clocknext organisation. Once your API key is set, your agent can identify your workspace, list enabled models, verify and record usage signals, read a customer's balances and plan, and manage your catalogue — see the full list of available tools.
Clocknext onboarding skill
The clocknext-onboarding skill gives your agent
Clocknext-specific procedural knowledge: the guided, sandbox-first playbook that
detects your models, creates entitlements and a plan, meters every billable call
in your codebase, and proves it with a dummy customer and live signals.
Manual installation
Prefer to install it by hand? Inside Claude Code, run the two commands above, or install from the marketplace explicitly:
The plugin format is Claude Code's — other agents use the MCP server and skill directly.
/plugin marketplace add Clocknext/clocknext-mcp
/plugin install clocknext@clocknextClaude Code prompts for your cnk_… key during install and stores it securely.
Run /plugin to manage installed plugins, and /mcp to confirm the clocknext
tools are connected.
You'll need an API key
The plugin authenticates with your organisation's cnk_… key from
Settings → API Keys. It's stored securely by Claude Code at install time —
never commit it to a repo. See
Settings → API keys.