Permite que un cliente de IA busque activos digitales, recomiende productos para un proyecto, descargue archivos de tu propiedad y proporcione enlaces de compra.
También conocido como kadalcc/store-cli, store-cli, @kadal/store
- Stars
- 0
- Herramientas
- 2
- Descargas, 30 días
- 1030
- Última versión
- 0.1.1
- Último commit
- 14 nov 2026
- Licencia
- AGPL-3.0
¿Qué es Kadal Store MCP?
Kadal Store es un MCP server. Permite que un cliente de IA busque activos digitales, recomiende productos para un proyecto, descargue archivos de tu propiedad y proporcione enlaces de compra. Expone 2 herramientas, como create_buy_link, whoami.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Kadal Store
Kadal Store permite encontrar activos digitales como modelos 3D, efectos de sonido o shaders para tus proyectos creativos mediante un agente de IA o una interfaz de terminal. Los desarrolladores y creadores pueden usar esta herramienta para buscar en una biblioteca de planners, arte, música y efectos de video, recibir recomendaciones de productos personalizadas según el contexto de su proyecto actual y gestionar su biblioteca digital existente.
Los usuarios conectan su propia cuenta de la tienda mediante un proceso de inicio de sesión que ocurre en el navegador para garantizar la seguridad. El servidor funciona con clientes de IA como Claude, ChatGPT, Cursor y VS Code mediante una conexión remota. Aunque el agente puede buscar artículos, recomendar productos específicos y proporcionar enlaces de compra, tiene restringido realizar pagos. Todas las transacciones deben ser completadas por el usuario a través de la propia página de pago de la tienda. La herramienta también permite descargar archivos específicos o sincronizar toda una colección de archivos propiedad del usuario en un directorio local.
Qué puedes hacer con él
- 1Obtener recomendaciones de productos personalizadasSolicita sugerencias de activos que coincidan con el tema o los requisitos de tu trabajo actual.
- 2Sincronizar toda tu bibliotecaReplica todos tus activos digitales comprados en una carpeta local para acceder a ellos sin conexión.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Kadal Store MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Kadal Store MCP en Claude Code
$ claude mcp add store-cli -- npx -y @kadal/storeInstalar Kadal Store MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Instalar Kadal Store MCP en VS Code
.vscode/mcp.json
{
"servers": {
"store-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Instalar Kadal Store MCP en VS Code CLI
$ code --add-mcp '{"name":"store-cli","type":"stdio","command":"npx","args":["-y","@kadal/store"]}'Instalar Kadal Store MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Instalar Kadal Store MCP en Codex
$ codex mcp add store-cli -- npx -y @kadal/storeInstalar Kadal Store MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.store-cli] command = "npx" args = ["-y", "@kadal/store"]
Instalar Kadal Store MCP en Gemini CLI
$ gemini mcp add -s user store-cli npx -- -y @kadal/storeInstalar Kadal Store MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Herramientas de Kadal Store MCP 2
Detectado desde el READMEcreate_buy_linkwhoami
| create_buy_link | — | |
| whoami | — |
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 accesiblekadalcc/store-cli is public and reachablegithub.com/kadalcc/store-cli ↗Aprobado
- El paquete indica este repositorio como su origen@kadal/store names kadalcc/store-cli as sourcenpmjs.com/package/@kadal/store ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for @kadal/storenpmjs.com/package/@kadal/store/v/0.1.1#provenance ↗Aprobado
- Licencia de código abierto (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/kadalcc/store-cli ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @kadal/storeAprobado
- No hay avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo2 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 MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en GitHubThe Kadal Store sells digital downloads: planners and printables, art
and icons, stickers, wallpapers, patterns, music, sound effects, 3D models, video FX and shaders.
You pay once and keep the files. @kadal/store brings the store to where you work. Search it, get
suggestions for the project in front of you, download and sync what you own, and get a link to buy
the rest. It works the same for you in a terminal and for the AI agent you already use, on your own
account and your own model subscription.
An agent can find things, download what you own and hand you a link. It can never pay: payment happens in Paddle's checkout, on the store's own page, in front of you.
Start in 30 seconds
You need Node 20 or newer.
npx -y @kadal/store login # once: approve on the store's own page
npx -y @kadal/store recommend "ui sounds" --from . # what fits the project you're in
npx -y @kadal/store download soft-ui-sounds -o assets/sfx # a product you own, into the project
Or install it with npm i -g @kadal/store, then run kadal-store <command>.
Rather have your agent do it? Give Claude, ChatGPT, Cursor or VS Code the address
https://store.kadal.cc/mcp. There is nothing to install: Connect your agent.
In the store
The code under each picture is the product's slug, which every command takes:
kadal-store show liquid-marble prints its files, prices and licence in the terminal. The pictures
are the store's own previews, so they change when the store does.
Sign in
$ kadal-store login
Opening your browser to sign in to store.kadal.cc. If it does not open, visit:
https://store.kadal.cc/authorize?response_type=code&client_id=…
Signed in as Ana <ana@example.com> on store.kadal.cc. Saved to /home/ana/.config/kadal/store.json
You sign in on the store's own page, so your password never passes through the CLI. The token is
saved in ~/.config/kadal/store.json ($XDG_CONFIG_HOME is respected; %APPDATA%\kadal\ on
Windows), readable only by you, and renews itself. On a machine without a browser, use
--no-open, open the address anywhere, and paste the address the browser lands on back into the
terminal. If the store's page says it does not know this app, run kadal-store login --register.
kadal-store logout signs this machine out and revokes its access; so does removing
"Kadal Store CLI" under Account → Settings → Connected apps.
Commands
Find
$ kadal-store search planner --max 10 --limit 5
72 Seasons Weekly Planner Printables $9.00 seventy-two-seasons-planner
Kakeibo Budget Planner Printables $8.00 kakeibo-budget-planner
2027 Small Business Planner Printables $8.00 small-business-planner-2027
2027 ADHD-Friendly Daily Planner Printables $8.00 adhd-friendly-planner
Christmas Planner Printables $7.00 christmas-planner
5 of 54. Details: kadal-store show <slug>
More: kadal-store search planner --cursor 5
search <words…>with--shelf <slug>,--style,--topic,--format,--kind asset|pack,--max <dollars>,--sort relevance|newest|price,--limit <1-50>(20),--cursor <next page>.shelveslists the store's shelves and how many products each holds (use a slug with--shelf).show <slug>: the price of each licence, what each licence allows and doesn't, the files with their sizes and editions, what a pack holds, and its updates.
Suggestions for your project
$ kadal-store recommend "sounds for a cosy pixel-art farming game" --limit 3
Retro 8-Bit SFX Sound FX from $9.00 retro-8bit-sfx
Matches “sound”, “pixel” and “art” in its tags.
Cute Pops & Sparkles Sound FX from $9.00 cute-pops-sparkles
Matches “sound”, “cosy” and “game” in its tags.
Holiday Creator Kit Bundles from $29.00 holiday-creator-kit (pack of 9)
Matches “sound”, “art” and “game” in its tags.
Packs that complete what you have:
Sound FX Collection Sound FX from $24.00 sfx-collection (pack of 4)
Holds 2 of the picks above. You already own 1 of its 4 items. Its 4 items cost $39 one by one; the pack is $24. (you own 1)
…
Every pick says why it was picked, and a pack says what it would save you. What you own is left out
(--include-owned keeps it). Add --from . and the store also reads a short summary of the project
you're in, which you see before it goes (what it holds). Also --shelf, --format
(both repeatable), --max <dollars>, --limit <1-20> (8), and --yes to send the summary without
asking.
What you own
$ kadal-store library
Slim Weekly Techo (standard) 42 files, 19.7 MB slim-weekly-techo
Soft UI Sounds (personal) 41 files, 1.8 MB soft-ui-sounds
Download one: kadal-store download <slug> · everything: kadal-store sync <dir>
$ kadal-store download slim-weekly-techo --year 2027 --lang en --size a6 -o planner
Downloading slim-weekly-techo into planner
✓ planner/FONT-LICENCE.txt
✓ planner/how-to-print.pdf
✓ planner/slim-weekly-techo_2027_en_a6.pdf
Done: 3 downloaded, 0 already here.
$ kadal-store sync Kadal
2 products · 83 files already in Kadal · 0 to download
Done: 0 downloaded, 83 already here.
-
download <slug>puts one product's files in./<slug>(or-o <dir>).--file <name>(repeatable) picks files. A product sold in editions takes--year 2027 --week sun|mon --lang en|ja|en-ja --size a4|a5|letter…to pick one;show <slug>lists the editions it has. Files that belong to every edition, like the read-me, always come too.--zipgets the whole product as one zip, and--forcedownloads files that are already there. -
sync [dir]mirrors everything you own intodir(default./kadal-store), one folder per product. Files already there with the same sha256 are skipped; nothing is ever deleted.--product <slug>(repeatable), the edition flags, and--dry-runto see what would come down. -
Recolourable illustrations (
show <slug>says "Recolourable") come in any colour:--color <hex>ondownloadorsync, such as--color 2f9e44, saves each SVG in that colour as<name>-2f9e44.svg, and the rest of the product as it is. Leave out the#or quote it ("#2f9e44"): a bare#starts a comment in the shell. Each recoloured file is checked against the store's sha256 for it, so the next run skips it too.sync --colorrecolours the products that can be and brings the rest as drawn; a product that can't take a colour is refused (exit 2). -
Every file is checked against the sha256 the store gives before it is kept. A download that is cut off leaves a
.kadal-partfile, and the next run picks up where it stopped. Downloads run four at a time (--concurrency <n>). -
Only what you own downloads. Anything else stops with the store's answer:
$ kadal-store download retro-8bit-sfx Downloading retro-8bit-sfx into retro-8bit-sfx error: You don't own Retro 8-Bit SFX. get_product describes it; create_buy_link makes a link to buy it.
Buy
$ kadal-store buy retro-8bit-sfx soft-ui-sounds
Review and pay here:
https://store.kadal.cc/buy?items=retro-8bit-sfx:personal,soft-ui-sounds:personal&ref=cli
Retro 8-Bit SFX personal $9.00
Soft UI Sounds personal $9.00 (you already own this)
Total $9.00
Open the link to review and pay. Nothing is charged until you pay on that page, and you can change a licence or remove anything there. Already owned, so not charged: soft-ui-sounds.
buy <slug[:tier]>… makes a page where you see each item, its licence and its price, and anything
you already own, which is left out of the total. Without a tier, an item comes with the cheapest
licence on sale for it; add one (personal, standard or commercial) to choose. --open
opens the page in your browser. Making that page is all buy does: you pay there, or not at all.
Tell us about a problem
$ kadal-store report slim-weekly-techo --kind question --file slim-weekly-techo_2027_en_a6-on-a4.pdf --page 3 "Do I print this one at 100% for an A6 binder?"
Thanks. Your note is open: https://store.kadal.cc/account/notes#note_…
Only you and Kadal can see it. Replies show up in `kadal-store notes`.
$ kadal-store notes
Slim Weekly Techo · question · slim-weekly-techo_2027_en_a6-on-a4.pdf [Waiting for Kadal to read it] note_…
Do I print this one at 100% for an A6 binder?
--kind mistake|question|idea; --page <n> for a PDF, --at <seconds> for audio or video. Use
- in place of the words to read them from stdin. notes --status open|accepted|declined|duplicate|fixed narrows the list. When a fix ships, the product's update
shows in your library and the next download or sync gets it.
Everything else
whoami, logout, --help (and <command> --help), --version.
Connect your agent
There are two servers with the same tools. The hosted one, https://store.kadal.cc/mcp, needs
nothing installed: your app signs in to the store with OAuth, and you choose what to allow. The
local one, npx -y @kadal/store mcp, uses this machine's kadal-store login and adds two tools
that work on the project folder. Both are one entry, cc.kadal/store, in the
official MCP Registry.
Claude (claude.ai and the desktop app)
Open Settings → Connectors, choose Add custom connector, paste https://store.kadal.cc/mcp
and connect. A store page opens: sign in and press Allow.
Claude Code
The plugin brings the skill and the local MCP server together. Sign in once with
npx -y @kadal/store login, then:
/plugin marketplace add kadalcc/store-cli
/plugin install kadal-store@kadal-store
Or add the hosted server alone, then run /mcp in Claude Code and pick kadal-store to sign in:
claude mcp add --transport http kadal-store https://store.kadal.cc/mcp
Or the local server alone: claude mcp add kadal-store -- npx -y @kadal/store mcp.
ChatGPT
In Settings → Apps & Connectors, turn on developer mode under Advanced, then create a
connector with the address https://store.kadal.cc/mcp and OAuth as the sign-in. ChatGPT opens the
store's sign-in the first time you use it.
Cursor
Add it to ~/.cursor/mcp.json:
{ "mcpServers": { "kadal-store": { "url": "https://store.kadal.cc/mcp" } } }
VS Code
Add it to .vscode/mcp.json, then start it from the file:
{ "servers": { "kadal-store": { "type": "http", "url": "https://store.kadal.cc/mcp" } } }
Codex, and apps that only run local servers
Sign in once with npx -y @kadal/store login, then point the app at the local server. In Codex,
that is ~/.codex/config.toml:
[mcp_servers.kadal-store]
command = "npx"
args = ["-y", "@kadal/store", "mcp"]
Claude Desktop, Cursor and other apps take the same local server as JSON:
{ "mcpServers": { "kadal-store": { "command": "npx", "args": ["-y", "@kadal/store", "mcp"] } } }
The skill
For any agent that reads Agent Skills: npx skills add kadalcc/store-cli
(skills/kadal-store).
It teaches the agent to find assets for the project in front of it, download into it, never buy on
its own, and report problems it finds in files you bought.
The tools
| MCP tools | |
|---|---|
search_products, get_product, list_shelves, recommend |
the catalogue, the licence of each product, suggestions from a description of the work |
list_library, get_download_links |
what you own, and ten-minute download links with each file's sha256 (a recolourable illustration's SVGs in the color you give) |
create_buy_link |
a review page for you to pay on; it charges nothing |
report_problem, list_my_notes |
a note about a file you own, and Kadal's replies |
whoami |
who is signed in, with which scopes |
project_summary (local) |
what recommend --from sends: the folder described without its contents |
download_to_folder (local) |
files you own into the project, checked by sha256, skipping what is there, in a color for recolourable illustrations; only inside the folder the server started in unless it was started with --allow-outside |
kadal-store mcp --dir <path> serves another folder as the project. Every tool needs the
store:read scope except report_problem, which needs store:write. The store's
server card lists every tool without
signing in.
Your agent never pays
- No tool can pay.
create_buy_link, likekadal-store buy, returns the address of a review page on store.kadal.cc. You pay there, in Paddle's checkout, in your own browser, signed in to the store. Nothing is charged until you do, and you can change a licence or remove anything first. - Downloads are only for what you own. Download links are made for the signed-in person, for
the files their licence covers, and last ten minutes. Anything else gets "You don't own …" and a
pointer to
create_buy_link. - You choose what it may do. Reporting a problem needs
store:write; everything else isstore:read. Remove an app under Account → Settings → Connected apps and its access ends. - The skill says so too. It tells the agent never to buy, never to say something was bought, never to open a checkout for you, and to ask you to sign in yourself.
Privacy
recommend --from <dir> and the local server's project_summary describe a project without its
contents. They read:
- from
package.json,pyproject.toml,Cargo.tomlorgo.mod: the name, description, keywords and the names of dependencies (never versions, scripts or anything else); - the README's headings, not its paragraphs;
- file names, to count file types and spot tools (a
project.godot,.blendfiles), and the top-level names.
Dependency, build and hidden folders (node_modules, .git, dist, any dot folder…) are not
read, symlinks are not followed, and the text is capped at 6,000 characters. You see exactly what
will be sent, and nothing goes until you say yes:
$ kadal-store recommend "ui sounds" --from .
This summary of /home/ana/cosy-farm will be sent to store.kadal.cc:
Project: cosy-farm — A cosy farming game
Built with: Phaser, Vite
Dependencies: phaser, vite
README sections: Cosy Farm · Art style · Controls
File types: .png 8, .ts 5, .html 1, .json 1, .md 1
Top level: assets/, src/, index.html, package.json, README.md
Send it? [y/N]
The folder's path is shown to you and not sent. With no terminal to ask in, nothing is sent unless
you pass --yes.
On the store's side, the words sent to recommend are used for that one answer and not kept. Each
connection records the app's name, what you allowed and when, and downloads are logged as they are
from your library. More in the store's privacy policy. On your
machine, the CLI keeps only its sign-in, as Sign in describes.
Preguntas sobre Kadal Store MCP
¿Cómo agrego Kadal Store MCP a Claude Code?
Ejecuta claude mcp add store-cli -- npx -y @kadal/store en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Kadal Store 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 Kadal Store MCP?
Expone 2 herramientas, incluidas create_buy_link, whoami.
¿Puede el agente de IA realizar compras?
No, el agente solo puede encontrar artículos y proporcionar enlaces. Los pagos los gestiona el usuario a través de la página de pago de la tienda.
¿Cómo funciona el proceso de inicio de sesión?
Inicias sesión a través de la propia página de la tienda en tu navegador, lo que garantiza que tu contraseña nunca se pase a través del CLI.