Clicks Protocol MCP server
✓ VerifiziertErmöglicht es AI Agents, Commerce Settlement Routing, Belegverifizierung und Transaktionsinspektion im Base Netzwerk durchzuführen.
Auch bekannt als clicks-protocol/clicks-protocol, @clicks-protocol/mcp-server
- Stars
- 2
- Tools
- 5
- Downloads, 30 Tage
- 232
- Neueste Version
- 1.0.3
- Letzter Commit
- 21. Juli 2026
- Lizenz
- MIT
Was ist Clicks Protocol MCP?
Ermöglicht es AI Agents, Commerce Settlement Routing, Belegverifizierung und Transaktionsinspektion im Base Netzwerk durchzuführen. Er stellt 5 Tools bereit, etwa clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement.
Zusammenfassung generiert aus dem README des Projekts
Über Clicks Protocol MCP server
Mit diesem Server wird es für AI Agents möglich, Commerce Settlement und Transaktionsinspektion im Base Netzwerk zu verwalten. Er bietet spezialisierte Tools, um die Integrität von Receipt V2 zu verifizieren und Settlement-Status zu inspizieren, einschließlich Witnesses und Retry-Policies. Entwickler können diese Tools nutzen, um Settlements abzugleichen, indem sie Base-Evidence lesen und Fail-Closed-States vorschlagen, ohne das Risiko einzugehen, dass der Server automatisch Transaktionen einreicht oder wiederholt.
Nutzer können ein lokales Append-only Ledger konfigurieren, indem sie die Umgebungsvariable CLICKS_RECEIPT_LEDGER_PATH setzen, um eine Receipt-Trail-Inspektion zu ermöglichen. Während die Read-only Receipt V2 Tools funktionieren, indem sie ein vollständiges Receipt JSON Objekt direkt akzeptieren, ohne einen Private Key zu benötigen, erfordern Write Tools einen CLICKS_PRIVATE_KEY. Aufgrund dieser Anforderung ist es wichtig, Write-fähige Instanzen von öffentlichen oder nicht vertrauenswürdigen Clients isoliert zu halten, um die Sicherheitsgrenzen zu wahren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Clicks Protocol MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenClicks Protocol MCP in Claude Code installieren
$ claude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-serverClicks Protocol MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Clicks Protocol MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Clicks Protocol MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@clicks-protocol/mcp-server"],"env":{"CLICKS_PRIVATE_KEY":"<YOUR_CLICKS_PRIVATE_KEY>"}}'Clicks Protocol MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Clicks Protocol MCP in Codex installieren
$ codex mcp add mcp-server --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' -- npx -y @clicks-protocol/mcp-serverClicks Protocol MCP in Codex config.toml installieren
~/.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>"
Clicks Protocol MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server npx -- -y @clicks-protocol/mcp-serverClicks Protocol MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@clicks-protocol/mcp-server"
],
"env": {
"CLICKS_PRIVATE_KEY": "<YOUR_CLICKS_PRIVATE_KEY>"
}
}
}
}Clicks Protocol MCP tools 5
Erkannt aus dem 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 | — |
Konfiguration
CLICKS_PRIVATE_KEYSecretPrivate key for write operations (register, deposit, withdraw). Not needed for read-only tools.
CLICKS_RPC_URLBase RPC URL. Defaults to https://mainnet.base.org
| Name | Beschreibung | Typ |
|---|---|---|
| CLICKS_PRIVATE_KEY | Private key for write operations (register, deposit, withdraw). Not needed for read-only tools. | Secret |
| CLICKS_RPC_URL | Base RPC URL. Defaults to https://mainnet.base.org |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarclicks-protocol/clicks-protocol is public and reachablegithub.com/clicks-protocol/clicks-protocol ↗Bestanden
- Paket nennt dieses Repository als Quelle@clicks-protocol/mcp-server names clicks-protocol/clicks-protocol as sourcenpmjs.com/package/@clicks-protocol/mcp-server ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-07-21github.com/clicks-protocol/clicks-protocol ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @clicks-protocol/mcp-serverBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten108 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenClicks 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.
Clicks Protocol MCP Fragen
Wie füge ich Clicks Protocol MCP zu Claude Code hinzu?
Führe claude mcp add --env 'CLICKS_PRIVATE_KEY=<YOUR_CLICKS_PRIVATE_KEY>' mcp-server -- npx -y @clicks-protocol/mcp-server in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Clicks Protocol MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Clicks Protocol MCP?
Er stellt 5 Tools bereit, darunter clicks_verify_receipt, clicks_get_settlement_status, clicks_reconcile_settlement, clicks_replay_policy, clicks_get_receipt_trail.
Benötige ich für alle Tools einen Private Key?
Nein, die Receipt V2 Tools akzeptieren ein vollständiges Receipt JSON Objekt direkt und benötigen keinen Private Key.
Wie kann ich die Receipt-Trail-Inspektion nutzen?
Du kannst die Receipt-Trail-Inspektion aktivieren, indem du die Umgebungsvariable CLICKS_RECEIPT_LEDGER_PATH setzt.
Was ist die Sicherheitsgrenze für Receipt Hashes?
Ein Receipt Hash beweist lediglich die Integrität des Objekts; er garantiert keine Zustellung oder kommerzielle Absicht.
Benötigen Write Tools eine Authentifizierung?
Ja, Write Tools erfordern einen CLICKS_PRIVATE_KEY und sollten von nicht vertrauenswürdigen Clients isoliert gehalten werden.