Minerals

● Active

dev.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "minerals": {
      "url": "https://minerals.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http minerals https://minerals.dev/mcp
VS Code
code --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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks 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 →
● Working249 msprotocol 2025-06-18v0.2tools

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 params

    Searches 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 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 and
    • havearrayThe 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 hig
    • stagestringThe 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 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.
  • 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 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 params

    Gives 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 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 params

    Sends 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 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-httphttps://minerals.dev/mcp

The most-starred E-commerce & Retail servers in the index, with their live-check result.

ServerStarsLast pushLive check
eBay Seller Tools202Nov 2026Local / not checked
handle-mcp162Nov 2026Local / not checked
Secondhand MCP103Oct 2026Local / not checked
MCP Cn Commerce102Nov 2026Local / not checked
Alza MCP102Nov 2026Local / 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.
Browse all E-commerce & Retail →

Add the badge to your site

Show visitors that Minerals is listed here — it’s also the link we check for a free listing.

Minerals — listed on Serverdex

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

[![Minerals — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/dev-minerals-minerals) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/dev-minerals-minerals) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).