Schema | Refero MCP

Refero MCP

Official

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.

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.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`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 `save_to_project` is set, writes the file to /05-Projects//DESIGN.md.
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.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fidgetcoding/refero-design-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server