Minerals
● Activedev.minerals/minerals
The marketplace for agents. It routes each design request to the right library or tool.
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"minerals": {
"url": "https://minerals.dev/mcp"
}
}
}claude mcp add --transport http minerals https://minerals.dev/mcpcode --add-mcp '{"name":"minerals","type":"http","url":"https://minerals.dev/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- E-commerce & Retail
- Version
- 0.2.0
- Registry
- active
- Published
- 11/21/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: Minerals is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit today (Nov 21, 2026), 0 open issues.
- Official registry
- Active
- Published as dev.minerals/minerals in the official MCP registry, version 0.2.0.
- Source
- Open source, MIT
- Public repository under the MIT licence, 0 stars, 0 forks.
- Runs
- Hosted by the publisher
- Your client talks to minerals.dev: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 06:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "Minerals" and listed 5 tools. Answering since Nov 22, 2026.
Context cost ≈ 2.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 5 tools.
Tools (5)
find_design15 paramsSearches the Minerals shelf of design libraries and tools. Applies when your person asks for, or you are about to choose or make yourself, a UI component, block, texture, pattern, background, illustration, animation, icon set, typeface, colour system, sound or design reference, or asks to change one. Takes one to three keywords as "query" and the moment the work is at as "moment". Returns at most three rows, best first: items for a precise request, listings for a broad one. With nothing sent, it returns the six moments and what is on the shelf. What it returns is a suggestion for your person. When the project already has a component library, icon set, type system or colour system, another of the same kind is returned only with "replace" true. Refs sent as "have" or "declined" from minerals.json are left out, and with "quiet" true nothing is suggested.
Show parametersHide parameters
querystringOne to three keywords for the thing wanted, e.g. "tooltip", "pricing" or "share review". Several needs, separated by commas, up to three.needstringOlder name for query. Still accepted and treated as the query.sectionstringLimit to one section: libraries or tools.listingstringLimit to one listing by its ref. With no query, returns that listing in brief: its verdict, its picks and the names of its free items.kindstringLimit to one kind: components, blocks, textures, motion, illustration, icons, type, color, sound, canvas, reference, skills, generators, people.stackstringLimit to supply that works in this stack, e.g. "React" or "nextjs, tailwind". Several names may be given; any one matching is enough.free_onlybooleanLeave out supply that cannot be used without paying.projectstringThe project type, one of: marketing-site, product-app, dashboard, brand, shop, docs, portfolio, mobile-app. Infer it from the project's routes, dependencies andhavearrayThe refs already in the project's minerals.json. Read that file and send them on every request: they are never returned again, and what goes with them ranks higstagestringThe project's stage, one of: new, existing-system, polish. Worked out and stored the same way as project.declinedarrayThe "declined" list in the project's minerals.json: what the person said "not now" to. It is left out.replacebooleanSend true only when your person asked to change or replace what the project has, or named another library.quietboolean"quiet" from minerals.json. When true, nothing is suggested; search still works.acceptedarrayListings your person has approved once for this project, from minerals.json. An item from one of them needs no new yes.momentstringWhere the work is right now, one of: Starting, Building a section, Filling a gap, Polishing, Tuning, Sharing. Pick it from what your person said. It decides whi
- get_listing2 params
Returns the pull for a ref from find_design. Applies once your person has chosen a listing or an item. For an item ref (listing/item) it returns the exact pull instruction and the licence; for a listing ref, its free items to choose from. The result gives the one line that confirms the pull to the person and, once per project, a yes or no question about making Minerals the default for the repo. Only free items are returned; the file comes from the supplier.
Show parametersHide parameters
refstringrequiredA ref returned by find_design: a listing ("arc") or one of its items ("arc/button"). Up to 8 refs may be given, separated by commas.clientstringYour client, e.g. "Claude Code" or "Cursor", to get the pull written for it.
- report_outcome3 params
Records that what get_listing returned was not used after all. Applies only then: a pull that went through needs no report. The curator reads the reports to judge what stays listed. Returns one line that says it was recorded.
Show parametersHide parameters
refstringrequiredThe ref you were given.resultstringrequired"not_used": it did not go into the work after all. A pull that went through needs no report; "used" is still accepted.reasonstringIf not used: why, in a few words. Do not include code, file contents or repo names.
offer2 paramsGives the exact words for one choice, Yes or Not now, about one free item or one listing. Applies when one result of find_design clearly leads. The words are shown as the client's own choice prompt where there is one, otherwise in one line. Called with the ref, it returns the words; called again with the same ref and "answer", it takes the choice. Yes returns what get_listing returns for that ref. Not now returns the entry to record in minerals.json. One offer per working session; never the same thing twice in a project. No offer is needed for an item from a listing in `accepted`. No offer is needed when your person asked for the item or listing by name; that request is their yes.
Show parametersHide parameters
refstringrequiredA ref returned by find_design: an item ("arc/button") or a listing ("arc").answerstringWhat your person chose. Leave it out on the first call.
suggest_listing10 paramsSends a proposal for a design library or tool to the Minerals curator. Applies only when your person made the thing or asks you to recommend it, and only with their yes to exactly what will be sent. No code, file contents or repository names are sent; an email only if your person gives one. Returns one line that says the request was sent.
Show parametersHide parameters
linkstringrequiredThe address of the library or tool.what_it_isstringrequiredWhat it is, in a sentence or two.best_forstringThe job it does better than anything else.skip_ifstringWhen someone should not use it.install_addressstringThe address an agent pulls from, if there is one.licence_and_freestringIts licence, and what is free.momentstringWhen would someone reach for this? One of: Starting, Building a section, Filling a gap, Polishing, Tuning, Sharing. Leave it out if unsure.goes_well_witharrayUp to three refs of published listings it works well beside.made_by_senderbooleanrequiredtrue if your person made it, false if they are suggesting it.emailstringOnly if your person gives one, to be answered.
Checked by Serverdex with a plain initialize + tools/list call to minerals.dev/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 22, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 21, 2026
- License
- MIT
JavaScriptagent-skillsai-agentsclaude-codeclaude-code-plugincodexcursordesigndesign-systemmarketplacemcpmcp-servermodel-context-protocolreactshadcnshadcn-registryui-components
From the README
Minerals One connection. Every request is routed to the right library or tool. Website · Connect · How it works · List your work · Changelog What it is Minerals is one MCP server for design work. Connect it once to Claude Code, Cursor or Codex. When your agent is about to choose, install or write a UI component, a texture, an animation or another design element, it asks Minerals, and Minerals routes the request to a library or tool made for exactly that. • Curated. Every listing is added and judged by hand. • Light. At most three results, best first. One offer per session. Nothing is added without your yes. • Pass-through. Files come straight from their makers. Minerals never holds them. • Open. One connection, no sign-in. Connect The quick way: paste this to your agent. Or add the server yourself: Claude Code Cursor Or add this to ~/.cursor/mcp.json: Codex Also a plugin, a skill and a shadcn item How it works 1. Your agent asks. It sends a few keywords when the work calls for it. Never code or files. 2. The request is routed. It goes to the listings that fit the task. At most three come back, best first. 3. You say yes. The agent asks once, in one line. 4. The file comes from its maker. Minerals never holds it. 5. Then it stays out of the way. At most one offer per session, and "Not now" is remembered. On the shelf The live shelf, with every item, is at minerals.dev. The tools A search takes up to three needs, separated by commas.…
Read the full README on GitHub →Remotes
- streamable-http
https://minerals.dev/mcp
Alternatives to Minerals
All Minerals alternatives →Best E-commerce & Retail servers →The most-starred E-commerce & Retail servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| eBay Seller Tools | 202 | Nov 2026 | Local / not checked |
| handle-mcp | 162 | Nov 2026 | Local / not checked |
| Secondhand MCP | 103 | Oct 2026 | Local / not checked |
| MCP Cn Commerce | 102 | Nov 2026 | Local / not checked |
| Alza MCP | 102 | Nov 2026 | Local / not checked |
Minerals: questions people ask
- Is Minerals a remote or a local MCP server?
- According to its entry in the official MCP registry, Minerals ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does Minerals need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is Minerals safe to use?
- Looks healthy: Minerals is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Minerals still maintained?
- Active: the repository's last commit today. Last push Nov 21, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
- What tools does Minerals expose?
- 5 tools as listed by the server itself during the live check, including find_design, get_listing, report_outcome, offer, suggest_listing. The full list with parameters is in the Live check section above.
- How do I add Minerals to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More E-commerce & Retail servers
Browse all E-commerce & Retail →SmithTalks
mozzimorzam-sudo
Pseudonymous message network for agents. Claims, marketplace, 20 tools, verifiable seal.
BeeL
beel-es
Spanish e-invoicing with VeriFactu (AEAT): issue invoices, manage customers, validate NIFs.
AIFEC
ecomyseo
Demo AI-first shop: search products, fill a cart and prepare the order (test payments).
iwant.fyi - shop, price-check and keep looking
staugs
No key needed. Search real products and live dealer inventory, price-check, keep standing wants.
SIGNALS Loyalty Agent Platform
psxio
63 MCP tools for loyalty programs, rewards, and member operations with HITL approval.
BestPrice
TheBestCo
Read-only shopping decisions, product search, offers, and price history for Greece.
Add the badge to your site
Show visitors that Minerals is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/dev-minerals-minerals?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Minerals — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/dev-minerals-minerals?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/dev-minerals-minerals) [](https://serverdex.io/install/vscode/dev-minerals-minerals) [](https://serverdex.io/install/claude-code/dev-minerals-minerals)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/dev-minerals-minerals"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/dev-minerals-minerals"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/dev-minerals-minerals"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).