Permite a los agentes de IA sellar, actualizar y verificar pruebas de documentos contra la blockchain de Bitcoin utilizando el protocolo OpenTimestamps.
También conocido como OTSkit/OTSkit-MCP, @otskit/mcp
- Stars
- 3
- Herramientas
- 9
- Descargas, 30 días
- —
- Última versión
- 0.2.1
- Último commit
- 12 nov 2026
- Licencia
- MIT
¿Qué es OTSkit MCP?
Permite a los agentes de IA sellar, actualizar y verificar pruebas de documentos contra la blockchain de Bitcoin utilizando el protocolo OpenTimestamps. Expone 9 herramientas, como create_timestamp, upgrade_timestamp, verify_timestamp.
Resumen generado a partir del README del proyecto
Acerca del MCP server de OTSkit
Con este MCP server, los desarrolladores pueden realizar el sellado de tiempo de documentos contra la blockchain de Bitcoin. Proporciona a los agentes de IA la capacidad de crear, monitorear y validar pruebas mediante el protocolo OpenTimestamps. Al conectarse con agentes como Claude Desktop, Claude Code o Codex, el servidor permite la creación de registros inmutables a través de hashing SHA-256 e integración con el calendario de Bitcoin.
Los usuarios interactúan con el servidor mediante herramientas como stamp_file para aplicar el hash y el sello de tiempo a archivos locales en un solo paso, o verify_timestamp para demostrar que un hash existía antes de un bloque de Bitcoin específico. El sistema gestiona los datos localmente usando una base de datos SQLite en el directorio del usuario y maneja la transición de las pruebas desde un estado pendiente hasta un estado confirmado. Incluye funciones especializadas como watch para monitorear las confirmaciones de la red y upgrade_timestamp para verificar la inclusión en bloques de Bitcoin, asegurando que los agentes puedan gestionar el ciclo de vida de una prueba sin intervención manual.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar OTSkit MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar OTSkit MCP en Claude Code
$ claude mcp add otskit-mcp -- npx -y @otskit/mcpInstalar OTSkit MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}Instalar OTSkit MCP en VS Code
.vscode/mcp.json
{
"servers": {
"otskit-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}Instalar OTSkit MCP en VS Code CLI
$ code --add-mcp '{"name":"otskit-mcp","type":"stdio","command":"npx","args":["-y","@otskit/mcp"]}'Instalar OTSkit MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}Instalar OTSkit MCP en Codex
$ codex mcp add otskit-mcp -- npx -y @otskit/mcpInstalar OTSkit MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.otskit-mcp] command = "npx" args = ["-y", "@otskit/mcp"]
Instalar OTSkit MCP en Gemini CLI
$ gemini mcp add -s user otskit-mcp npx -- -y @otskit/mcpInstalar OTSkit MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"otskit-mcp": {
"command": "npx",
"args": [
"-y",
"@otskit/mcp"
]
}
}
}Herramientas de OTSkit MCP 9
Detectado desde el READMEcreate_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 | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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.
Preguntas sobre OTSkit MCP
¿Cómo agrego OTSkit MCP a Claude Code?
Ejecuta claude mcp add otskit-mcp -- npx -y @otskit/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego OTSkit MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona OTSkit MCP?
Expone 9 herramientas, incluidas create_timestamp, upgrade_timestamp, verify_timestamp, verify_external_proof, inspect_timestamp.
¿Dónde se almacenan los datos?
Todos los datos, incluyendo la base de datos SQLite y los archivos de registro, se almacenan en el directorio ~/.ots-mcp/.