Refero MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENAI_API_KEY | No | OpenAI API key for vibe search via text-embedding-3-small. Without it, search falls back to keyword scoring. | |
| REFERO_API_BASE | No | Override the base URL for the Refero API. Default is https://styles.refero.design | https://styles.refero.design |
| REFERO_CACHE_DIR | No | Directory for local catalog mirror, embeddings, and detail cache. Default is ~/.refero-cache | ~/.refero-cache |
| REFERO_CACHE_TTL_MS | No | How long a cached page is considered fresh in milliseconds. Default is 86400000 (24h). | 86400000 |
| REFERO_MCP_VAULT_DIR | No | Absolute path to vault root for writing DESIGN.md files. If unset, refero_design_md returns markdown but does not write to disk. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| refero_searchA | Natural-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. |
| refero_getA | Fetch 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. |
| refero_design_mdA | Render a Refero style as an agent-friendly DESIGN.md (frontmatter, north star, color table, fonts, dos/donts, tags). When |
| refero_similarA | Refero's own "similar styles" recommendation list for a given style. Useful for follow-up exploration once you've found a candidate via refero_search. |
| refero_listA | Browse the local catalog mirror with optional theme/tag filters. Returns paginated, stably-ordered results (newest first, then site name). |
| refero_refreshA | Force 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: fetching details, browsing, searching, refreshing, getting recommendations, and generating design docs. No overlap in functionality.
All tools share the 'refero_' prefix and use lowercase with underscores, but the suffixes vary between verbs (get, list, refresh, search) and non-verbs (similar, design_md), causing slight inconsistency.
6 tools is well-scoped for interacting with a design system catalog, covering key operations without being too few or too many.
The tool set covers browsing, searching, fetching details, getting recommendations, refreshing the catalog, and generating documentation. Minor gaps like filtering by popularity are absent but core workflows are complete.