Provides a cross-vendor kill switch and spend guard to manage and audit financial transactions for AI agents.
別名 countersign-network/packages, @countersign/mcp
- スター
- 1
- ツール
- 5
- ダウンロード数(30日間)
- 232
- 最新バージョン
- 0.2.2
- 最終コミット
- 2026年11月3日
- ライセンス
- —
Countersign MCPとは
CountersignはMCPサーバーです。 Provides a cross-vendor kill switch and spend guard to manage and audit financial transactions for AI agents. 5個のツールを提供しており、countersign_request_spend, countersign_freeze, countersign_apply_policyなどがあります。
プロジェクトのREADMEから生成された概要
Countersign MCP server について
Countersign provides a centralized control plane for managing financial transactions performed by AI agents. It functions as a cross-vendor spend guard and kill switch, allowing developers to implement unified policies, such as spending caps or allow lists, across multiple wallet and card backends. The server operates by connecting to a Countersign Core instance via a URL, requiring an API key if authentication is enabled on your specific Core setup.
Users can integrate this server into MCP clients like Claude Desktop, Claude Code, or Cursor using npx. The toolset includes specific commands for safety and auditing, such as countersign_request_spend for pre-flight checks and countersign_freeze to halt all agent activity across every backend in under a second. It also features a tamper-evident, hash-chained audit ledger via the countersign_ledger tool to ensure transaction history remains verifiable and secure.
できること
- 1Verify transaction permissionAsk the agent to check if a specific expenditure is permitted before it interacts with a wallet.
- 2Emergency agent shutdownImmediately halt all agent activity across every connected backend using a single command.
- 3Manage spending constraintsDeploy a single set of rules including spending limits and approval thresholds to all agent backends.
- 4Audit financial historyAccess a secure, append-only record to verify the history of agent transactions.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Countersign MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにCountersign MCPをインストール
$ claude mcp add --env 'COUNTERSIGN_API_KEY=<YOUR_COUNTERSIGN_API_KEY>' --env 'COUNTERSIGN_URL=<COUNTERSIGN_URL>' countersign -- npx -y @countersign/mcpCursorにCountersign MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"countersign": {
"command": "npx",
"args": [
"-y",
"@countersign/mcp"
],
"env": {
"COUNTERSIGN_API_KEY": "<YOUR_COUNTERSIGN_API_KEY>",
"COUNTERSIGN_URL": "<COUNTERSIGN_URL>"
}
}
}
}VS CodeにCountersign MCPをインストール
.vscode/mcp.json
{
"servers": {
"countersign": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@countersign/mcp"
],
"env": {
"COUNTERSIGN_API_KEY": "<YOUR_COUNTERSIGN_API_KEY>",
"COUNTERSIGN_URL": "<COUNTERSIGN_URL>"
}
}
}
}VS Code CLIにCountersign MCPをインストール
$ code --add-mcp '{"name":"countersign","type":"stdio","command":"npx","args":["-y","@countersign/mcp"],"env":{"COUNTERSIGN_API_KEY":"<YOUR_COUNTERSIGN_API_KEY>","COUNTERSIGN_URL":"<COUNTERSIGN_URL>"}}'Claude DesktopにCountersign MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"countersign": {
"command": "npx",
"args": [
"-y",
"@countersign/mcp"
],
"env": {
"COUNTERSIGN_API_KEY": "<YOUR_COUNTERSIGN_API_KEY>",
"COUNTERSIGN_URL": "<COUNTERSIGN_URL>"
}
}
}
}CodexにCountersign MCPをインストール
$ codex mcp add countersign --env 'COUNTERSIGN_API_KEY=<YOUR_COUNTERSIGN_API_KEY>' --env 'COUNTERSIGN_URL=<COUNTERSIGN_URL>' -- npx -y @countersign/mcpCodex config.tomlにCountersign MCPをインストール
~/.codex/config.toml
[mcp_servers.countersign] command = "npx" args = ["-y", "@countersign/mcp"] [mcp_servers.countersign.env] COUNTERSIGN_API_KEY = "<YOUR_COUNTERSIGN_API_KEY>" COUNTERSIGN_URL = "<COUNTERSIGN_URL>"
Gemini CLIにCountersign MCPをインストール
$ gemini mcp add -s user -e 'COUNTERSIGN_API_KEY=<YOUR_COUNTERSIGN_API_KEY>' -e 'COUNTERSIGN_URL=<COUNTERSIGN_URL>' countersign npx -- -y @countersign/mcpGemini settings.jsonにCountersign MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"countersign": {
"command": "npx",
"args": [
"-y",
"@countersign/mcp"
],
"env": {
"COUNTERSIGN_API_KEY": "<YOUR_COUNTERSIGN_API_KEY>",
"COUNTERSIGN_URL": "<COUNTERSIGN_URL>"
}
}
}
}Countersign MCPツール 5
READMEから検出countersign_request_spendcountersign_freezecountersign_apply_policycountersign_ledgercountersign_unfreeze
| countersign_request_spend | — | |
| countersign_freeze | — | |
| countersign_apply_policy | — | |
| countersign_ledger | — | |
| countersign_unfreeze | — |
設定
COUNTERSIGN_API_KEY必須シークレットAPI key for the Core (self-serve one at https://app.countersign.network/start or POST /signup).
COUNTERSIGN_URL必須Base URL of the Countersign Core to govern (hosted or self-hosted).
| 名前 | 説明 | 種類 |
|---|---|---|
| COUNTERSIGN_API_KEY | API key for the Core (self-serve one at https://app.countersign.network/start or POST /signup). | 必須シークレット |
| COUNTERSIGN_URL | Base URL of the Countersign Core to govern (hosted or self-hosted). | 必須 |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能countersign-network/packages is public and reachablegithub.com/countersign-network/packages ↗合格
- パッケージがこのリポジトリをソースとして指定@countersign/mcp names countersign-network/packages as sourcenpmjs.com/package/@countersign/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for @countersign/mcpnpmjs.com/package/@countersign/mcp/v/0.2.2#provenance ↗合格
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-03github.com/countersign-network/packages ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @countersign/mcp合格
- パッケージおよびその依存関係に重大な勧告なし104 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない5 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る@countersign/mcp
The cross-vendor kill switch + spend guard for AI agents — as MCP tools, inside any MCP client.
Countersign is a neutral control plane that holds one policy, one freeze, and one tamper-evident audit ledger across every agent-wallet backend at once. This package exposes it as Model Context Protocol tools, so an agent (or you, from chat in Claude / Cursor) can ask "may I spend this?" before acting — and freeze everything in under a second.
Tools
| Tool | What it does |
|---|---|
countersign_request_spend |
Pre-flight guard — ask whether a spend is allowed before touching the wallet (allow / deny / needs_approval). |
countersign_freeze |
The kill switch — freeze every agent on every backend at once. |
countersign_apply_policy |
Apply one unified policy (caps, allow/deny lists, approval threshold) across all backends. |
countersign_list_agents / countersign_health |
See the governed fleet + control-plane health. |
countersign_list_approvals / countersign_approve / countersign_deny |
The human-approval queue. |
countersign_ledger |
Read + re-verify the append-only, hash-chained audit ledger. |
countersign_unfreeze |
Lift a freeze (recover). |
Setup
It governs a running Countersign Core. The hosted Core at app.countersign.network is paused since
2026-09-18 and answers 503, so point this at a Core you run yourself. Set:
COUNTERSIGN_URL— your Core, e.g.https://app.countersign.networkCOUNTERSIGN_API_KEY— required when the Core has auth enabled
Claude Desktop / Claude Code / Cursor
Add to your MCP config (claude_desktop_config.json, or claude mcp add, or Cursor's mcp.json):
{
"mcpServers": {
"countersign": {
"command": "npx",
"args": ["-y", "@countersign/mcp"],
"env": {
"COUNTERSIGN_URL": "https://app.countersign.network",
"COUNTERSIGN_API_KEY": "csk_…"
}
}
}
}
That's it — your agent now has the spend guard and the kill switch.
Show it (the "powered by" badge)
If Countersign guards your agent, say so — it tells users (and other agents) that spending is governed, and points the next operator at the same kill switch. Drop this in your README:
[](https://countersign.network)
Listing in MCP registries (distribution)
Countersign spreads by being easy to discover wherever agent builders look for tools. The metadata below is ready to submit to the common registries — copy it as-is.
- Official MCP registry (
registry.modelcontextprotocol.io/ themcp-registryrepo) — entry:{ "name": "io.github.countersign-network/countersign", "description": "Cross-vendor kill switch + spend guard for AI agents that spend money — one policy, one freeze, one tamper-evident ledger across every wallet/card backend.", "homepage": "https://countersign.network", "repository": "https://github.com/countersign-network/countersign", "packages": [ { "registry": "npm", "name": "@countersign/mcp", "runtime": "npx" } ], "license": "Apache-2.0" } - mcp.so — submit
@countersign/mcp; category Finance / Security / Agents. - Smithery —
npx-launched server; envCOUNTERSIGN_URL(defaulthttps://app.countersign.network) + optionalCOUNTERSIGN_API_KEY. - awesome-mcp-servers lists — one-liner:
Countersign — cross-vendor spend guard + sub-second kill switch + tamper-evident ledger for AI agents that move money (Coinbase, Turnkey, Openfort, Visa card). Testnet.
Standard listing fields:
| Field | Value |
|---|---|
| Server id | countersign |
| Launch | npx -y @countersign/mcp |
| Tools | countersign_request_spend, countersign_freeze, countersign_apply_policy, countersign_list_agents, countersign_health, countersign_list_approvals, countersign_approve, countersign_deny, countersign_ledger, countersign_unfreeze |
| Tags | payments · security · kill-switch · spend-guard · agent-payments · wallet |
Nothing here is auto-submitted — listings are made deliberately by a maintainer.
Apache-2.0. Countersign holds policy/freeze/ledger; it never takes custody of funds. Testnet only.
Countersign MCPのよくある質問
Countersign MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'COUNTERSIGN_API_KEY=<YOUR_COUNTERSIGN_API_KEY>' --env 'COUNTERSIGN_URL=<COUNTERSIGN_URL>' countersign -- npx -y @countersign/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Countersign MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Countersign MCPが提供するツールは
5個のツールを提供しており、countersign_request_spend, countersign_freeze, countersign_apply_policy, countersign_ledger, countersign_unfreezeなどがあります。
Does Countersign take custody of my funds?
No, Countersign only manages policies, freezes, and the ledger; it does not hold custody of any funds.
How quickly can I freeze an agent?
You can freeze all agents across every backend in under one second.