# MCP

> MCP is an MCP server for finance and payments. Meter usage and manage usage-based billing in Clocknext from AI coding tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/clocknext-inc/clocknext-mcp
- **MCP Registry name:** io.github.Clocknext-Inc/mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env CLOCKNEXT_API_KEY='<CLOCKNEXT_API_KEY>' -- npx -y @clocknext/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clocknext/mcp"
      ],
      "env": {
        "CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clocknext/mcp"
      ],
      "env": {
        "CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@clocknext/mcp"
      ],
      "env": {
        "CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clocknext/mcp"
      ],
      "env": {
        "CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@clocknext/mcp"
      ],
      "env": {
        "CLOCKNEXT_API_KEY": "<CLOCKNEXT_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_docs`: Search the Clocknext documentation.
- `get_doc`: Fetch a Clocknext documentation page.

## 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.

## Alternatives

- [Locus](https://ai-powered.com/mcp/locus-2): Locus is a freemium MCP server for finance and payments.
- [Kodelyth ECC](https://ai-powered.com/mcp/kodelyth-ecc): Kodelyth ECC is an open-source MCP server for developer tools.
- [MCP](https://ai-powered.com/mcp/mcp-mwenkagg): MCP is a freemium MCP server for developer tools.
- [MCP Claude Usage Guard](https://ai-powered.com/mcp/mcp-claude-usage-guard): MCP Claude Usage Guard is an open-source MCP server for developer tools.
- [codai](https://ai-powered.com/mcp/codai): codai is an MCP server for ai models and llm tooling.
- [Simular](https://ai-powered.com/mcp/simular): Simular is a freemium MCP server for developer tools.
- [ByMorning](https://ai-powered.com/mcp/bymorning): ByMorning is an open-source MCP server for ai models and llm tooling.
- [JiZhiMCP](https://ai-powered.com/mcp/jizhimcp): JiZhiMCP is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-mwenpji1
