MCP
Meter usage and manage usage-based billing in Clocknext from AI coding tools
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.14.3
- Listing updated
- 3 days ago
Similar MCP servers
About MCP
MCP is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
This local stdio server lets a coding agent work with Clocknext, a usage-based billing service, using your organisation's cnk_ API key held in the server's environment so it never enters the model's context. Optional settings point it at a staging API or a different docs host, and it has tools to search and fetch Clocknext documentation.
The repository ships a companion onboarding skill that drives the tools through a human-in-the-loop, sandbox-first flow: detect the models used, entitlements, plan, meter the codebase, then test with a dummy customer. The skill installs for many agents through npx skills, and a Claude Code plugin bundles the server and skill and prompts for the key.
The README gives configuration for Claude Code, Gemini CLI, Codex, Copilot CLI, OpenCode, Cursor, Windsurf, Kiro, VS Code and others. A Clocknext account and API key are required, and Clocknext pricing is not described there.
Install
Run in a terminal
claude mcp add mcp --env CLOCKNEXT_API_KEY='<CLOCKNEXT_API_KEY>' -- npx -y @clocknext/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clocknext/mcp"
],
"env": {
"CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clocknext/mcp"
],
"env": {
"CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clocknext/mcp"
],
"env": {
"CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clocknext/mcp"
],
"env": {
"CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@clocknext/mcp"
],
"env": {
"CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
CLOCKNEXT_API_KEYYour organisation's cnk_… API key (Settings → API Keys).RequiredCLOCKNEXT_BASE_URLOverride the API origin (e.g. a staging URL). Defaults to production.CLOCKNEXT_DOCS_URLOverride the docs origin for the search_docs/get_doc tools. Defaults to https://help.clocknext.com.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- search_docs
- Search the Clocknext documentation.
- get_doc
- Fetch a Clocknext documentation page.
What it does
- Usage metering
- Meter usage and verify signals from your codebase.
- Billing management
- Manage usage-based billing through the Clocknext API.
- Docs tools
- search_docs and get_doc read the Clocknext help site.
- Onboarding skill
- Guided, sandbox-first setup playbook for coding agents.
- Secret stays local
- The API key lives in the server environment, not the model.
- Broad client support
- Config snippets for many CLI agents and IDEs.
Good for
- Add usage metering to an app with an agent
- Verify metered signals in a sandbox
- Look up Clocknext docs during setup
- Test billing with a dummy customer
Pricing
Pricing unknown
Requires a Clocknext API key; pricing not stated
MCP FAQ
What do I need?
A Clocknext account and a cnk_ API key from Settings, API Keys.
How is it run?
Locally over stdio with npx -y @clocknext/mcp.
Where does the key go?
In the CLOCKNEXT_API_KEY environment variable of the server process.
Is there a Claude Code plugin?
Yes, it bundles the server and the onboarding skill.
How do I add MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp --env CLOCKNEXT_API_KEY='<CLOCKNEXT_API_KEY>' -- npx -y @clocknext/mcp
What are the best alternatives to MCP?
The closest alternatives to MCP are Locus, Kodelyth ECC, MCP, MCP Claude Usage Guard and codai.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.