KlickyMart MCP server
Commit Nov 3, 2026Lets AI shopping agents discover online stores, checkout workflows, and accepted payment methods including Bitcoin.
Also known as FloppyKit/klickymart
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 2026.10.31
- Last commit
- Nov 3, 2026
- License
- MIT
What is KlickyMart MCP?
KlickyMart lets AI shopping agents discover online stores, checkout workflows, and accepted payment methods including Bitcoin.
Summary generated from the project's README
About KlickyMart MCP server
Helping AI shopping agents navigate online stores and checkout processes is what KlickyMart enables. This service provides a signed map of merchants, detailing how their checkout workflows function and which payment methods they accept, with a specific focus on Bitcoin and privacy-respecting options. It is designed for software agents that need to verify if they can successfully complete a purchase at a specific domain.
Developers can connect to the service via a remote MCP endpoint using a stateless Streamable HTTP transport. It works with Cursor or Claude Desktop through the mcp-remote bridge, requiring no API keys for standard tool use. The available tools include search_merchants, get_record, check_domain, and submit_review. The system relies on Nostr events for publishing records and allows users to submit signed reviews using kind 422 events to maintain pseudonymity.
KlickyMart distinguishes itself through strict crawler guardrails. The system respects robots.txt, avoids bypassing captchas, and never accesses private account data or performs form submissions beyond adding items to a cart. It records findings such as terms-of-service restrictions or access blocks without attempting to circumvent them.
What you can do with it
- 1Verify merchant compatibilityAsk the agent to check if a specific website allows automated shopping agents to access its checkout.
- 2Discover Bitcoin-friendly storesSearch for online retailers that specifically accept Bitcoin or privacy-focused payment methods.
- 3Audit merchant payment methodsRetrieve detailed information about the specific payment options available at a particular online store.
- 4Submit merchant feedbackProvide a signed review of a merchant's checkout experience using a dedicated keypair.
Written from the project's README. Every use case is checked against a quote from it.
How to install KlickyMart MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall KlickyMart MCP in Claude Code
$ claude mcp add --transport http klickymart https://klickymart.com/mcpInstall KlickyMart MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"klickymart": {
"url": "https://klickymart.com/mcp"
}
}
}Install KlickyMart MCP in VS Code
.vscode/mcp.json
{
"servers": {
"klickymart": {
"type": "http",
"url": "https://klickymart.com/mcp"
}
}
}Install KlickyMart MCP in VS Code CLI
$ code --add-mcp '{"name":"klickymart","type":"http","url":"https://klickymart.com/mcp"}'Install KlickyMart MCP in Codex
$ codex mcp add klickymart --url https://klickymart.com/mcpInstall KlickyMart MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.klickymart] url = "https://klickymart.com/mcp"
Install KlickyMart MCP in Gemini CLI
$ gemini mcp add -s user --transport http klickymart https://klickymart.com/mcpInstall KlickyMart MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"klickymart": {
"url": "https://klickymart.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablefloppykit/klickymart is public and reachablegithub.com/floppykit/klickymart ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/floppykit/klickymart ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 717 msPass
README
View on GitHubKlickyMart
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 questions
How do I add KlickyMart MCP to Claude Code?
Run claude mcp add --transport http klickymart https://klickymart.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add KlickyMart MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can an AI agent use KlickyMart?
Agents can use the MCP endpoint to search merchants, get specific records, or check domains using tools like search_merchants and check_domain.
Does using the KlickyMart MCP require an API key?
No, the MCP endpoint does not require an authentication key.
Can I opt out of being crawled by KlickyMart?
Yes, you can opt out by adding 'User-agent: FloppyKitMapBot' and 'Disallow: /' to your robots.txt file.
What kind of information is recorded about stores?
The service maps whether an agent can reach a store, how checkout works, and which payment methods are accepted, specifically noting Bitcoin options.