OTSkit MCPとは
OpenTimestampsプロトコルを使用して、Bitcoinブロックチェーンに対するドキュメントのタイムスタンプ作成、アップグレード、および証明の検証をAIエージェントに可能にします。 9個のツールを提供しており、create_timestamp, upgrade_timestamp, verify_timestampなどがあります。
プロジェクトのREADMEから生成された概要
OTSkit MCP server について
このMCP serverを使用することで、開発者はドキュメントをBitcoinブロックチェーンに対してタイムスタンプすることができます。OpenTimestampsプロトコルを利用して、AIエージェントが証明の作成、監視、および検証を行う機能を提供します。Claude Desktop、Claude Code、またはCodexなどのエージェントと連携することで、SHA-256ハッシュ化とBitcoinカレンダーの統合を通じて、不変の記録を作成できます。
ユーザーは、ローカルファイルを1ステップでハッシュ化してタイムスタンプを付与する stamp_file や、特定のBitcoinブロックの前にハッシュが存在していたことを証明する verify_timestamp などのツールを介してサーバーを操作します。システムはユーザーディレクトリ内のSQLiteデータベースを使用してデータをローカルで管理し、証明のステータスを保留状態から確定状態へと遷移させます。また、ネットワークの確定を監視する watch や、Bitcoinブロックへの含まれ方を確認する upgrade_timestamp といった専用の機能が含まれており、エージェントが手動の介入なしに証明のライフサイクルを管理できるようにします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
OTSkit MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにOTSkit MCPをインストール
$ claude mcp add otskit-mcp -- npx -y @otskit/mcpCursorにOTSkit MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}VS CodeにOTSkit MCPをインストール
.vscode/mcp.json
{
"servers": {
"otskit-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}VS Code CLIにOTSkit MCPをインストール
$ code --add-mcp '{"name":"otskit-mcp","type":"stdio","command":"npx","args":["-y","@otskit/mcp"]}'Claude DesktopにOTSkit MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}CodexにOTSkit MCPをインストール
$ codex mcp add otskit-mcp -- npx -y @otskit/mcpCodex config.tomlにOTSkit MCPをインストール
~/.codex/config.toml
[mcp_servers.otskit-mcp] command = "npx" args = ["-y", "@otskit/mcp"]
Gemini CLIにOTSkit MCPをインストール
$ gemini mcp add -s user otskit-mcp npx -- -y @otskit/mcpGemini settings.jsonにOTSkit MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}OTSkit MCPツール 9
READMEから検出create_timestampupgrade_timestampverify_timestampverify_external_proofinspect_timestamplist_pendingwatchhash_filestamp_file
| create_timestamp | — | |
| upgrade_timestamp | — | |
| verify_timestamp | — | |
| verify_external_proof | — | |
| inspect_timestamp | — | |
| list_pending | — | |
| watch | — | |
| hash_file | — | |
| stamp_file | — |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見る@otskit/mcp
OpenTimestamps MCP server - stamp, upgrade, and verify Bitcoin timestamps via AI agents.
Exposes a set of tools to any MCP-compatible agent so it can timestamp documents, monitor confirmation status, and verify proofs against the Bitcoin blockchain - all from a conversation.
This is an independent implementation of the OpenTimestamps protocol. It is not affiliated with, endorsed by, or maintained by the OpenTimestamps project.
Note on confirmation times: After stamping, a proof is
pendinguntil Bitcoin confirms it. Confirmations typically arrive within ~60 minutes, but can take several hours during network congestion. Useots-mcp watchorupgrade_timestampto monitor. A pending proof is not a failed proof.
Install
npm install -g @otskit/mcp
Agent setup
ots-mcp setup claude # Claude Desktop
ots-mcp setup claude-code # Claude Code CLI
ots-mcp setup codex # Codex CLI
Each command writes the MCP entry into the agent's config file, makes a .bak backup if the file already exists, and skips if ots-mcp is already configured. Restart the agent afterwards to apply the changes.
CLI commands
| Command | Description |
|---|---|
ots-mcp serve |
Start the MCP server (stdio transport) |
ots-mcp stamp <sha256> |
Stamp a SHA-256 hash against Bitcoin calendars |
ots-mcp upgrade <id> |
Check if a pending stamp has been confirmed |
ots-mcp verify <id> |
Verify a stamp against Bitcoin |
ots-mcp list [status] |
List stamps (pending / confirmed / failed) |
ots-mcp watch [minutes] |
Monitor pending stamps and attempt due upgrades (default: 30 min, minimum: 15 min) |
ots-mcp check-pending |
Run one upgrade pass over all pending stamps |
ots-mcp scheduler install|remove|status |
Manage OS-level scheduler for auto-upgrades |
ots-mcp backup [dest] |
Backup the SQLite database |
ots-mcp setup <claude|claude-code|codex> |
Configure MCP for an agent |
MCP tools exposed to agents
| Tool | Description |
|---|---|
create_timestamp |
Stamp a SHA-256 hash against 4 public OTS calendars |
upgrade_timestamp |
Check if a pending stamp has been confirmed in Bitcoin |
verify_timestamp |
Verify a stamp - proves hash existed before a given Bitcoin block |
verify_external_proof |
Verify a whitelisted local file against its external .ots proof, without changing the local stamp store |
inspect_timestamp |
Inspect a stored proof file without network calls |
list_pending |
List stamps with status, retry count, and filters |
watch |
Open a terminal window monitoring pending stamps and attempting due upgrades |
hash_file |
Compute the SHA-256 of a local file and return it as a 64-char hex string (no network calls) |
stamp_file |
Compute SHA-256 of a local file and stamp it on Bitcoin in one step |
Data directory
All data is stored in ~/.ots-mcp/:
~/.ots-mcp/
ots-mcp.db # SQLite database (stamps, proof files)
config.json # Optional config overrides
ots-mcp.log # Log file
Configuration
Create ~/.ots-mcp/config.json to override defaults:
{
"stamp_enabled": true,
"scheduler_interval_minutes": 30,
"retry_max_attempts": 20,
"calendar_timeout_ms": 10000,
"calendars": [
"https://alice.btc.calendar.opentimestamps.org",
"https://bob.btc.calendar.opentimestamps.org",
"https://finney.calendar.eternitywall.com",
"https://btc.calendar.catallaxy.com"
]
}
Development
npm run build # production build
npm run dev # watch mode
npm test # run tests
Dependencies
@otskit/client- OTS calendar client (brings in@otskit/core, the protocol engine)@modelcontextprotocol/sdk- MCP SDKnode-sqlite3-wasm- local database (pure WASM, no native compilation)
Requires Node.js >= 20.
OTSkit MCPのよくある質問
OTSkit MCPをClaude Codeに追加するには
ターミナルでclaude mcp add otskit-mcp -- npx -y @otskit/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
OTSkit MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
OTSkit MCPが提供するツールは
9個のツールを提供しており、create_timestamp, upgrade_timestamp, verify_timestamp, verify_external_proof, inspect_timestampなどがあります。
データはどこに保存されますか?
SQLiteデータベースやログファイルを含むすべてのデータは、~/.ots-mcp/ ディレクトリに保存されます。