OTSkit MCP란?
OpenTimestamps 프로토콜을 사용하여 AI agent가 Bitcoin 블록체인에 문서 증명을 스탬프하고, 업그레이드하며, 검증할 수 있도록 합니다. 9개 도구를 제공합니다. 예: create_timestamp, upgrade_timestamp, verify_timestamp.
프로젝트 README에서 생성된 요약
OTSkit MCP server 정보
이 MCP server를 사용하면 개발자는 Bitcoin 블록체인을 기반으로 문서에 타임스탬프를 찍을 수 있습니다. OpenTimestamps 프로토콜을 통해 AI agent가 증명을 생성, 모니터링 및 검증할 수 있는 기능을 제공합니다. Claude Desktop, Claude Code 또는 Codex와 같은 agent에 연결하여 SHA-256 해싱과 Bitcoin calendar 통합을 통해 불변의 기록을 생성할 수 있습니다.
사용자는 stamp_file 도구를 사용하여 로컬 파일의 해싱과 타임스탬프 생성을 한 번에 수행하거나, verify_timestamp를 사용하여 특정 Bitcoin 블록 이전에 해시가 존재했음을 증명할 수 있습니다. 시스템은 사용자 디렉토리의 SQLite 데이터베이스를 사용하여 데이터를 로컬에서 관리하며, 증명이 대기 상태에서 확정 상태로 전환되는 과정을 처리합니다. 또한 네트워크 확정 상태를 모니터링하는 watch 기능과 Bitcoin 블록 포함 여부를 확인하는 upgrade_timestamp와 같은 특화된 기능을 포함하고 있어, agent가 수동 개입 없이 증명의 라이프사이클을 관리할 수 있습니다.
프로젝트의 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
OTSkit MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: create_timestamp, upgrade_timestamp, verify_timestamp, verify_external_proof, inspect_timestamp.
데이터는 어디에 저장되나요?
SQLite 데이터베이스와 로그 파일을 포함한 모든 데이터는 ~/.ots-mcp/ 디렉토리에 저장됩니다.