godly-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GODLY_UA | No | User-Agent sent to the API | godly-mcp/<version> |
| GODLY_INDEX | No | Index file | ~/.godly-mcp/index.json |
| GODLY_MEDIA_DIR | No | Where `godly_media` saves when `save: true` | ~/godly-media |
| GODLY_INDEX_TTL_H | No | Hours before the index is rebuilt | 12 |
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 | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| godly_searchA | Busca referências de design no Godly (hoje Recent Design): interfaces, microinterações, motion, sites com animação forte, branding, OG images, ícones e telas de app. Casa com título, descrição, criador e tags (ex: 'dark', '3d', 'scroll-animation', 'microinteraction', 'saas', 'portfolio'). Termos em inglês funcionam melhor. Primeira chamada monta um índice local (uns segundos); depois é instantâneo. |
| godly_browseA | Lista ao vivo um feed do Godly/Recent Design na ordem do site (recentes, populares ou staff picks), com filtro de categoria/tag e paginação. x = posts de design garimpados do X (interface, motion, branding, web...), websites = sites gravados em vídeo (o Godly clássico), launch-videos, og-images, app-store-screenshots, app-icons, tools, skills. |
| godly_getA | Detalhes completos de um item: descrição, criador e link do post/site original, tags por tipo (cor, estilo, interação, framework...), PALETA extraída (hex + % da tela), lista de mídias (vídeo/imagem) e, em tools/skills, preço, links e comando de instalação. Aceita URL recent.design/i/..., URL antiga do godly, id (7 letras) ou slug. |
| godly_taxonomyA | Lista as categorias (com quantos posts) e as tags existentes agrupadas por tipo (color, style, interaction, type, framework, component...), pra usar como filtro em godly_search e godly_browse. |
| godly_mediaA | Mostra a referência pro modelo: baixa o still (poster do vídeo ou a imagem) de cada mídia do item e devolve como imagem. Pra motion, peça frames > 0: baixa o vídeo e tira N frames espalhados (precisa de ffmpeg). Por padrão nada fica no disco; save=true guarda em ~/godly-media/. |
| godly_statusA | Checa se a API do Recent Design responde, o estado do índice local e se o ffmpeg está instalado. refresh=true reconstrói o índice. |
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
The pair godly_search and godly_browse is the only real overlap, and the descriptions work hard to separate them (text/tag matching vs. a live site-ordered feed with pagination). godly_get vs godly_media is clearly split between metadata/text and actually surfacing images or extracted frames, and taxonomy/status are unambiguous helpers.
All six tools use a uniform godly_ prefix, giving a predictable namespace. The second word mixes verbs (search, browse, get) with nouns (taxonomy, status, media), but each name is short, readable, and clearly maps to its operation.
Six tools is well-scoped for a read-only design-reference lookup service: discovery (taxonomy, search, browse), retrieval (get, media), and diagnostics (status) each earn their place. Nothing feels padded or missing at the count level.
The surface covers the full read lifecycle: filters, search, live feed, item details, media extraction, and health/index rebuilding. Minor gaps exist, such as no explicit pagination on search or a related/similar-items lookup, but agents can work around these via browse and tag filters.