Enables searching the Refero design catalog in plain English and generates DESIGN.md files for any project
Installation and connection instructions are shown only when supported by retained package, repository, or endpoint evidence.
Version 0.2.0 declares 1 executable entrypoint.
npm install --save-exact fidgetcoding-refero-mcp@0.2.0npx -y -p fidgetcoding-refero-mcp@0.2.0 fidgetcoding-refero-mcp{
"mcpServers": {
"fidgetcoding-refero-mcp": {
"command": "npx",
"args": [
"-y",
"-p",
"fidgetcoding-refero-mcp@0.2.0",
"fidgetcoding-refero-mcp"
]
}
}
}| Canonical slug | refero-mcp-a252f441 | Deployment | Local Only |
|---|---|---|---|
| Canonical package | npm:fidgetcoding-refero-mcp | Repository | fidgetcoding/refero-design-mcp |
| First published | — | Latest release | — |
| Last security verification | Aug 19, 2026 | Classification confidence | 90% |
| Publication | Published | Official distribution | Yes |
| Channel | Identifier | Current version | Versions | Source |
|---|---|---|---|---|
| npm | fidgetcoding-refero-mcp | 0.2.0 | 1 | Repository |
| Package | Version | Published / observed | Inventory | Security scan |
|---|---|---|---|---|
| npmfidgetcoding-refero-mcp | 0.2.0Current | Sep 5, 2026 | 7 toolsSucceeded · 0 resources · 0 prompts | Failed |
Independently scan the exact version your agents use, receive alerts when its risk changes, and investigate every finding with retained version evidence.
| Provenance | artifact_hash_verified | Signature | — |
|---|---|---|---|
| MCP SDK | @modelcontextprotocol/sdk | Artifact SHA-256 | bdce37357df943cf3b2e0fe22830808e335589ef3e253ad54e98e9a971ba0e75 |
| Scanner | mcp-proof-engine 0.1.0 | Scan completed | Aug 20, 2026 |
| Security rating | 37 / 100 | Methodology | version-rating-1.0 |
[ "fidgetcoding-refero-mcp" ]
[ "security_policy_not_observed" ]
| Tool | Category | Annotations | Risk |
|---|---|---|---|
refero_design_mdRender a Refero style as an agent-friendly DESIGN.md (frontmatter, north star, color table, fonts, dos/donts, tags). When `save_to_project` is set, writes the file to <vault>/05-Projects/<NAME>/DESIGN.md.Input schema{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "uuid, hostname/URL, or site name to render."
},
"save_to_project": {
"type": "string",
"description": "Vault project folder name (e.g. \"PARZVL\"). Sanitized; must be [A-Za-z0-9_.-]."
}
},
"required": [
"identifier"
],
"additionalProperties": false
} | — | — | |
refero_facetsDiscover what the catalog actually contains: ranked font stacks, color names, and theme counts. Call this BEFORE guessing search terms — the catalog has no tag taxonomy, so invented tags match nothing, while any font or color returned here can be passed straight to refero_search as a query.Input schema{
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"light",
"dark"
],
"description": "Restrict the facet counts to light- or dark-themed sites."
},
"limit": {
"type": "number",
"description": "How many font and color values to return (default 25, max 100)."
}
},
"additionalProperties": false
} | — | — | |
refero_getFetch the full design system for a single style. Accepts a uuid, a hostname/URL (e.g. cursor.com), or a site name (e.g. "Cursor"). Fuzzy-matches site names within Levenshtein distance 2.Input schema{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "uuid, hostname/URL, or site name."
}
},
"required": [
"identifier"
],
"additionalProperties": false
} | — | — | |
refero_listBrowse the local catalog mirror with optional theme/tag filters. Returns paginated, stably-ordered results (newest first, then site name).Input schema{
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"light",
"dark"
],
"description": "Filter to light- or dark-themed sites only."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by tag terms (matched against siteName + northStar in the catalog projection)."
},
"page": {
"type": "number",
"description": "1-indexed page number (default 1)."
},
"limit": {
"type": "number",
"description": "Items per page (default 20, max 50)."
}
},
"additionalProperties": false
} | — | — | |
refero_refreshForce a full re-fetch of the styles.refero.design catalog and overwrite the local mirror. Useful after the catalog has changed and you don't want to wait for the 24h TTL.Input schema{
"type": "object",
"properties": {},
"additionalProperties": false
} | — | — | |
refero_searchNatural-language search over the styles.refero.design catalog. Returns the top matches scored by an embedding model (when OPENAI_API_KEY is set) or a BM25-lite keyword fallback. The local catalog is mirrored on first call and refreshed automatically every 24 hours.Input schema{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Natural-language vibe query, e.g. \"playful neobrutalist saas\"."
},
"theme": {
"type": "string",
"enum": [
"light",
"dark"
],
"description": "Filter to light- or dark-themed sites only."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to styles whose tags / name / northStar mention any of these terms."
},
"limit": {
"type": "number",
"description": "How many results to return (default 10, max 50)."
}
},
"required": [
"query"
],
"additionalProperties": false
} | — | — | |
refero_similarRefero's own "similar styles" recommendation list for a given style. Useful for follow-up exploration once you've found a candidate via refero_search.Input schema{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "uuid, hostname/URL, or site name."
},
"limit": {
"type": "number",
"description": "How many similar styles to return (default 10, max 20)."
}
},
"required": [
"identifier"
],
"additionalProperties": false
} | — | — |
| Endpoint | Transport | Authentication | Health | Observed |
|---|---|---|---|---|
| No verified remote endpoint is linked. | ||||
Install the selected package version with: npm install --save-exact fidgetcoding-refero-mcp@0.2.0
Refero MCP Server exposed 7 tools during independent protocol observation, including refero_design_md, refero_facets, refero_get, refero_list, refero_refresh, refero_search, refero_similar.
Our scanner tested version 0.2.0 without proving a finding in the methods exercised. This is not a guarantee that every deployment is secure.
Curated product and capability guides containing this catalog record.