MCP server de Clicks Protocol
✓ VerificadoPermite que los agentes de IA realicen el enrutamiento de liquidación comercial, la verificación de recibos y la inspección de transacciones en la red Base.
También conocido como clicks-protocol/clicks-protocol, @clicks-protocol/mcp-server
- Stars
- 2
- Herramientas
- 5
- Descargas, 30 días
- 232
- Última versión
- 1.0.3
- Último commit
- 21 jul 2026
- Licencia
- MIT
¿Qué es Clicks Protocol MCP?
Permite que los agentes de IA realicen el enrutamiento de liquidación comercial, la verificación de recibos y la inspección de transacciones en la red Base. Expone 5 herramientas, como clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Clicks Protocol
Gestionar la liquidación comercial y la inspección de transacciones en la red Base es posible para los agentes de IA utilizando este servidor. Proporciona herramientas especializadas para verificar la integridad de Receipt V2 e inspeccionar los estados de liquidación, incluyendo testigos y políticas de reintento. Los desarrolladores pueden usar estas herramientas para conciliar liquidaciones leyendo evidencia de Base y proponiendo estados de cierre por fallo (fail-closed) sin el riesgo de que el servidor envíe o reintente transacciones automáticamente.
Los usuarios pueden configurar un libro contable local de solo anexos (append-only) configurando la variable de entorno CLICKS_RECEIPT_LEDGER_PATH para habilitar la inspección de receipt trail. Mientras que las herramientas de solo lectura de Receipt V2 funcionan aceptando directamente un objeto JSON de recibo completo sin necesidad de una clave privada, las herramientas de escritura requieren una CLICKS_PRIVATE_KEY. Debido a este requisito, es importante mantener las instancias con permisos de escritura aisladas de clientes públicos o no confiables para mantener los límites de seguridad.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Clicks Protocol MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Clicks Protocol MCP en Claude Code
$ claude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-serverInstalar Clicks Protocol MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Instalar Clicks Protocol MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Instalar Clicks Protocol MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@clicks-protocol/mcp-server"],"env":{"CLICKS_PRIVATE_KEY":"<YOUR_CLICKS_PRIVATE_KEY>"}}'Instalar Clicks Protocol MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Instalar Clicks Protocol MCP en Codex
$ codex mcp add mcp-server --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' -- npx -y @clicks-protocol/mcp-serverInstalar Clicks Protocol MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@clicks-protocol/mcp-server"] [mcp_servers.mcp-server.env] CLICKS_PRIVATE_KEY = "<YOUR_CLICKS_PRIVATE_KEY>"
Instalar Clicks Protocol MCP en Gemini CLI
$ gemini mcp add -s user -e 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server npx -- -y @clicks-protocol/mcp-serverInstalar Clicks Protocol MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Herramientas de Clicks Protocol MCP 5
Detectado desde el READMEclicks_verify_receiptclicks_get_settlement_statusclicks_reconcile_settlementclicks_replay_policyclicks_get_receipt_trail
| clicks_verify_receipt | — | |
| clicks_get_settlement_status | — | |
| clicks_reconcile_settlement | — | |
| clicks_replay_policy | — | |
| clicks_get_receipt_trail | — |
Configuración
CLICKS_PRIVATE_KEYSecretoPrivate key for write operations (register, deposit, withdraw). Not needed for read-only tools.
CLICKS_RPC_URLBase RPC URL. Defaults to https://mainnet.base.org
| Nombre | Descripción | Tipo |
|---|---|---|
| CLICKS_PRIVATE_KEY | Private key for write operations (register, deposit, withdraw). Not needed for read-only tools. | Secreto |
| CLICKS_RPC_URL | Base RPC URL. Defaults to https://mainnet.base.org |
Verificaciones automáticas
Ejecutado 15 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 accesibleclicks-protocol/clicks-protocol is public and reachablegithub.com/clicks-protocol/clicks-protocol ↗Aprobado
- El paquete indica este repositorio como su origen@clicks-protocol/mcp-server names clicks-protocol/clicks-protocol as sourcenpmjs.com/package/@clicks-protocol/mcp-server ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-07-21github.com/clicks-protocol/clicks-protocol ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @clicks-protocol/mcp-serverAprobado
- No hay avisos críticos en el paquete ni en sus dependencias108 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubClicks Protocol MCP Server
MCP tools for agent-commerce settlement routing and inspection on Base.
Receipt V2 read tools
clicks_verify_receipt: verifies deterministic Receipt V2 integrity.clicks_get_settlement_status: reads state, witnesses and retry policy.clicks_reconcile_settlement: reads Base evidence and proposes a fail-closed state. It never submits or retries a transaction.clicks_replay_policy: compares an exact policy definition with the policy hash bound to a receipt.clicks_get_receipt_trail: reads matching versions from a configured local append-only ledger.
Set CLICKS_RECEIPT_LEDGER_PATH to use receipt-trail inspection. The other Receipt V2 tools accept a complete receipt JSON object directly and do not require a private key.
Safety boundary
Receipt hash validity proves object integrity only. It does not prove delivery or commercial intent. Missing RPC data is treated as unknown, not as proof that no transaction was submitted. Only the SDK state failed_before_transfer, established with independent evidence, can permit a bounded retry.
Write tools still require CLICKS_PRIVATE_KEY. Keep write-enabled MCP servers isolated from public or untrusted clients.
Preguntas sobre Clicks Protocol MCP
¿Cómo agrego Clicks Protocol MCP a Claude Code?
Ejecuta claude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-server en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Clicks Protocol 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 Clicks Protocol MCP?
Expone 5 herramientas, incluidas clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement, clicks_replay_policy, clicks_get_receipt_trail.
¿Necesito una clave privada para todas las herramientas?
No, las herramientas de Receipt V2 aceptan directamente un objeto JSON de recibo completo y no requieren una clave privada.
¿Cómo puedo usar la inspección de receipt-trail?
Puedes habilitar la inspección de receipt-trail configurando la variable de entorno CLICKS_RECEIPT_LEDGER_PATH.
¿Cuál es el límite de seguridad para los hashes de recibos?
Un hash de recibo solo demuestra la integridad del objeto; no garantiza la entrega ni la intención comercial.
¿Las herramientas de escritura requieren autenticación?
Sí, las herramientas de escritura requieren una CLICKS_PRIVATE_KEY y deben mantenerse aisladas de clientes no confiables.