KlickyMart MCP server
Commit 3. Nov. 2026Ermöglicht es AI-Shopping-Agents, Online-Shops, Checkout-Workflows und akzeptierte Zahlungsmethoden, einschließlich Bitcoin, zu entdecken.
Auch bekannt als FloppyKit/klickymart
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 2026.10.31
- Letzter Commit
- 3. Nov. 2026
- Lizenz
- MIT
Was ist KlickyMart MCP?
Ermöglicht es AI-Shopping-Agents, Online-Shops, Checkout-Workflows und akzeptierte Zahlungsmethoden, einschließlich Bitcoin, zu entdecken.
Zusammenfassung generiert aus dem README des Projekts
Über KlickyMart MCP server
KlickyMart hilft AI-Shopping-Agents dabei, sich in Online-Shops und Checkout-Prozessen zurechtzufinden. Der Service bietet eine signierte Map von Merchants und liefert Details dazu, wie deren Checkout-Workflows funktionieren und welche Zahlungsmethoden sie akzeptieren, mit einem speziellen Fokus auf Bitcoin und datenschutzfreundliche Optionen. Er ist für Software-Agents konzipiert, die verifizieren müssen, ob sie einen Kauf auf einer bestimmten Domain erfolgreich abschließen können.
Entwickler können sich über einen Remote MCP-Endpoint via stateless Streamable HTTP transport mit dem Service verbinden. Er funktioniert mit Cursor oder Claude Desktop über die mcp-remote Bridge und benötigt für die Standard-Tool-Nutzung keine API-Keys. Zu den verfügbaren Tools gehören search_merchants, get_record, check_domain und submit_review. Das System nutzt Nostr-Events zur Veröffentlichung von Datensätzen und erlaubt es Nutzern, signierte Reviews mittels kind 422 Events einzureichen, um die Pseudonymität zu wahren.
KlickyMart unterscheidet sich durch strikte Crawler-Guardrails. Das System respektiert die robots.txt, umgeht keine Captchas und greift niemals auf private Kontodaten zu oder führt Formular-Submissions durch, die über das Hinzufügen von Artikeln zum Warenkorb hinausgehen. Es protokolliert Erkenntnisse wie Einschränkungen in den Terms of Service oder Zugriffssperren, ohne zu versuchen, diese zu umgehen.
Was du damit machen kannst
- 1Kompatibilität von Merchants prüfenLass den Agent prüfen, ob eine bestimmte Website automatisierten Shopping-Agents den Zugriff auf den Checkout erlaubt.
- 2Bitcoin-freundliche Stores entdeckenSuche nach Online-Händlern, die explizit Bitcoin oder datenschutzorientierte Zahlungsmethoden akzeptieren.
- 3Zahlungsmethoden von Merchants auditierenRufe detaillierte Informationen über die spezifischen Zahlungsoptionen ab, die in einem bestimmten Online-Shop verfügbar sind.
- 4Feedback zu Merchants einreichenGib ein signiertes Review über die Checkout-Experience eines Merchants unter Verwendung eines dedizierten Keypairs ab.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du KlickyMart MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenKlickyMart MCP in Claude Code installieren
$ claude mcp add --transport http klickymart https://klickymart.com/mcpKlickyMart MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"klickymart": {
"url": "https://klickymart.com/mcp"
}
}
}KlickyMart MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"klickymart": {
"type": "http",
"url": "https://klickymart.com/mcp"
}
}
}KlickyMart MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"klickymart","type":"http","url":"https://klickymart.com/mcp"}'KlickyMart MCP in Codex installieren
$ codex mcp add klickymart --url https://klickymart.com/mcpKlickyMart MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.klickymart] url = "https://klickymart.com/mcp"
KlickyMart MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http klickymart https://klickymart.com/mcpKlickyMart MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"klickymart": {
"url": "https://klickymart.com/mcp",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarfloppykit/klickymart is public and reachablegithub.com/floppykit/klickymart ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-03github.com/floppykit/klickymart ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 717 msBestanden
README
Auf GitHub ansehenKlickyMart
KlickyMart is a public, signed map of online stores for software agents: whether an agent can reach a store, how checkout works, and which payment methods the store accepts, with attention to Bitcoin and privacy-respecting Bitcoin options. Records are published as Nostr events (see NIP-DRAFT.md). A FloppyKit project.
Status: draft. No crawl data is published in this repository yet.
Contents
NIP-DRAFT.md: draft event kinds for the directory and payment handshakes.CRAWL-RUBRIC.md: record schema and grading rules (v0.3 draft changes at the end).CASCADE.md: build plan.crawler/: Playwright crawler (crawl.py), deterministic payment extractor (extract.py), terms-of-service checker (tos.py), signing helpers, tests.crawler/KNOWN-LIMITATIONS.md: known limitations.site/bot/index.html: the crawler info and opt-out page, served at https://klickymart.com/bot.site/: KlickyMart web app (Worker, API, dashboard). See site/README.md.
Use it from an agent (MCP)
Agents should start at https://klickymart.com/llms.txt. MCP endpoint: https://klickymart.com/mcp. It uses a minimal, stateless Streamable HTTP transport: one JSON-RPC message per POST, answered with a single application/json body. It negotiates protocol versions 2024-11-05, 2025-03-26 or 2025-06-18 (tools only). There is no SSE stream and no session ID, and GET /mcp returns 405. Tools: search_merchants, get_record, check_domain. No key needed.
Claude Desktop (claude_desktop_config.json launches stdio servers, so this goes through the mcp-remote bridge, which needs Node.js):
{
"mcpServers": {
"klickymart": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://klickymart.com/mcp"
]
}
}
}
Cursor (~/.cursor/mcp.json or .cursor/mcp.json):
{
"mcpServers": {
"klickymart": {
"url": "https://klickymart.com/mcp"
}
}
}
Any Streamable HTTP client:
curl -s https://klickymart.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \\
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_domain","arguments":{"domain":"example.com"}}}'
Reviews: anyone can review a merchant with a signed kind 422 event (a tag 31420:<record-author>:<domain>, rating, attempt, optional pay). Submit it with POST /reviews (?dry_run=1 validates without storing) or the MCP tool submit_review, and read reviews with GET /reviews?domain= or get_reviews. Agents should use a fresh keypair dedicated to KlickyMart for pseudonymity and must never send a secret key. Reviews are signed claims; we verify signatures and format, not the opinion. Full guide: /llms.txt and /about#reviews. Spec: NIP-DRAFT.md → "422 as a merchant review".
Plain HTTP: GET /check?domain=example.com answers "can my agent shop here?" from the index only. It never starts a live crawl.
Crawler guardrails
- Honest user agent:
FloppyKitMapBot/0.2 (+https://klickymart.com/bot). No stealth plugins or fingerprint changes, no proxies or IP rotation. - robots.txt is read first; an error, 401, 403 or timeout means the whole site is treated as disallowed.
- If a site's terms ban automated access, the site is not crawled; only that finding is recorded, with a quote and URL.
- Public pages only: no login, no accounts, no orders, no payment details, no form submits beyond add-to-cart, no captcha solving. Blocks are recorded as findings.
- At least 2 s between requests, at most 10 pages per site.
- Customer reviews, Q&A and comments are never used as evidence. Every payment method in a record carries a quote and a URL; unknowns stay null.
Opt out: add User-agent: FloppyKitMapBot / Disallow: / to robots.txt. Details: https://klickymart.com/bot
Run the tests
cd crawler
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt && python -m playwright install chromium
python -m unittest discover -s tests -v
The tests use synthetic fixtures and make no network requests.
License
- Software (this repository, including the crawler and site Worker): MIT License.
- Crawl records (API JSON, NDJSON export, published directory data): CC0 1.0 Universal (public domain).
See also site/README.md.
KlickyMart MCP Fragen
Wie füge ich KlickyMart MCP zu Claude Code hinzu?
Führe claude mcp add --transport http klickymart https://klickymart.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich KlickyMart MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie kann ein AI-Agent KlickyMart nutzen?
Agents können den MCP-Endpoint nutzen, um nach Merchants zu suchen, spezifische Datensätze abzurufen oder Domains mit Tools wie search_merchants und check_domain zu prüfen.
Benötigt die Nutzung des KlickyMart MCP einen API-Key?
Nein, der MCP-Endpoint erfordert keinen Authentifizierungsschlüssel.
Kann ich verhindern, dass KlickyMart meine Seite crawlt?
Ja, du kannst dich aussperren, indem du 'User-agent: FloppyKitMapBot' und 'Disallow: /' in deine robots.txt Datei einträgst.
Welche Informationen werden über die Stores gespeichert?
Der Service erfasst, ob ein Agent einen Store erreichen kann, wie der Checkout funktioniert und welche Zahlungsmethoden akzeptiert werden, wobei ein besonderer Fokus auf Bitcoin-Optionen liegt.