Design inspiration MCP for Codex
Use website references with Codex to compare layouts, inspect typography and colors, and turn visual ideas into practical design guidance.
design inspiration mcp for codex
Contents
- [Choose references for a specific decision](#choose-references-for-a-specific-decision)
- [Ask Codex to compare the same details](#ask-codex-to-compare-the-same-details)
- [Turn the comparison into a build plan](#turn-the-comparison-into-a-build-plan)
- [Review the result before shipping](#review-the-result-before-shipping)
- [Use this in your AI agent](#use-this-in-your-ai-agent)
A design inspiration MCP for Codex lets you give your coding agent concrete website references instead of relying on vague descriptions. The useful workflow is to collect a few strong examples, compare what they actually do, then ask Codex to turn those observations into an implementation plan for your project.
Choose references for a specific decision
Start with three to five references that match the job you are doing. Choose examples for a clear reason: a landing page with a strong hero, a documentation site with clear navigation, a dashboard with useful density, or a product page with a polished signup flow. Avoid collecting a large mood board before you know what you want to compare.
For each reference, write one purpose such as "compare its heading hierarchy," "study its navigation," or "look at how it presents technical benefits." Include at least one example whose content density resembles your own. A visually striking editorial page may offer useful type ideas but still be a poor model for a technical product.
Open the examples below and compare their opening screens before borrowing a pattern. The Notion Developer Platform, Claude Code, and Exa MCP Server references represent different ways to present a developer-focused product. Look at hierarchy, density, and emphasis rather than treating any one card as a template.
Captured pages
Ask Codex to compare the same details
Use a consistent checklist so the loudest visual feature does not dominate the decision:
- What is visible in the opening screen, and which action is emphasized?
- How are the header, navigation, hero, sections, and calls to action arranged?
- Which typefaces, weights, sizes, line heights, and text widths create hierarchy?
- Which colors serve the page, text, actions, borders, and supporting surfaces?
- What spacing, radii, shadows, gradients, and image treatments repeat?
- What changes on narrow screens?
- Which patterns fit your product, and which should be rejected?
Ask Codex to separate observations from recommendations. Observations describe what is visible. Recommendations explain what could work in your project and why. If you need an exact font, color, or spacing value, ask Codex to verify it directly. If the available information supports only a visual description, keep the recommendation at that level rather than inventing a value.
Turn the comparison into a build plan
Have Codex produce a brief before changing files. It should include:
- Structure: the sections and component order.
- Visual rules: type roles, color roles, spacing steps, borders, radii, and shadows.
- Component plan: which existing components can express each section.
- Responsive behavior: what stacks, shrinks, hides, or remains visible.
- Acceptance checks: the details you will compare after implementation.
Request named variables or design tokens instead of scattered one-off values. For example, ask for page background, raised surface, primary text, muted text, action color, border color, spacing scale, and radius scale. This makes the reference easier to adapt when your codebase already has a theme.
Keep the first code pass narrow. Build the hero or another representative section, review it in the browser, then extend the approved rules. This catches wrong assumptions about type scale, spacing, and component reuse before they spread through the page.
Review the result before shipping
Use a simple scorecard:
| Area | Question |
|---|---|
| Clarity | Can a visitor understand the page quickly? |
| Hierarchy | Is it obvious what to look at and do next? |
| Density | Is there enough information without crowding? |
| Responsiveness | Does the layout remain useful on narrow screens? |
| Fit | Does the pattern suit your product rather than the reference? |
Ask Codex to report mismatches in priority order and separate measurable issues from taste. Review the result yourself for content clarity, keyboard use, contrast, and interactions. Inspiration should reduce decisions, not replace your judgment or copy another site's identity.
Use this in your AI agent
> Review these website references as design inspiration for my current project. Compare their opening screen, page structure, typography, colors, spacing, borders, radii, shadows, responsive behavior, and calls to action. Create a concise design brief with reusable visual rules, explain which patterns fit my product and which do not, then propose an implementation plan using my existing components. Do not copy any site's branding or content. After implementation, compare the result against the brief and return a prioritized list of fixes.
Install Fudge for your AI agent to give Codex a practical way to work from saved website references.
How should I choose the best website references for a Codex design task?
Choose references by the decision you need to make, not by how impressive the site looks. For a developer landing page, collect one example for page hierarchy, one for navigation, one for explaining technical benefits, and one for responsive behavior. Keep the set small enough that Codex can compare each example consistently.
Before adding a reference, write one reason it belongs, such as "strong product explanation," "useful dense layout," or "good mobile navigation." Remove examples that do not answer a specific question. Include one reference whose content density resembles your own. A striking editorial page may offer useful type ideas but still be a poor model for a technical product.
Ask Codex to separate observations from recommendations. Observations describe what is visible. Recommendations explain what could work in your project and why. This keeps inspiration from turning into accidental copying and makes disagreements easier to resolve.
What should I ask Codex to build after it compares my design references?
Ask for a design brief before asking for a full implementation. The brief should name the page sections, component states, visual tokens, responsive rules, and acceptance checks. Then ask Codex to map each recommendation to an existing component or file in your project.
A useful sequence is:
- Confirm the page structure.
- Add the type and color variables.
- Build one representative section.
- Check spacing, hierarchy, and responsive behavior.
- Extend the approved rules to the remaining sections.
- Compare the result with the brief and remove copied or unnecessary details.
Tell Codex to make small, reviewable changes and preserve existing behavior. At the end, ask it to list what changed, which reference informed each major choice, and which decisions still need your judgment.