protogrid
Sign inAdd to your agent

Search / ai.thedesignagent/mcp

TheDesignAgent

R2· OAuth, once

A design agent in your coding agent's loop: briefs each screen, reviews UX and visual quality.

v0.5.3 · active · website · descriptor JSON · versions

An agent can connect after a one-time OAuth consent by a human.Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.
Quality92strong
Trust83of 100
Uptime, 30 days100%
Latency p50298 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "thedesignagent": {
      "type": "http",
      "url": "https://www.thedesignagent.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${THEDESIGNAGENT_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http thedesignagent https://www.thedesignagent.ai/mcp --header "Authorization: Bearer ${THEDESIGNAGENT_TOKEN}"
[mcp_servers.thedesignagent]
url = "https://www.thedesignagent.ai/mcp"
bearer_token_env_var = "THEDESIGNAGENT_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "thedesignagent": {
      "type": "remote",
      "url": "https://www.thedesignagent.ai/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:THEDESIGNAGENT_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "thedesignagent": {
      "type": "http",
      "url": "https://www.thedesignagent.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${THEDESIGNAGENT_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=thedesignagent&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd3d3LnRoZWRlc2lnbmFnZW50LmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1RIRURFU0lHTkFHRU5UX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "thedesignagent": {
      "type": "http",
      "url": "https://www.thedesignagent.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${THEDESIGNAGENT_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "thedesignagent": {
      "httpUrl": "https://www.thedesignagent.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${THEDESIGNAGENT_TOKEN}"
      }
    }
  }
}
extensions:
  "thedesignagent":
    enabled: true
    name: "thedesignagent"
    type: streamable_http
    uri: "https://www.thedesignagent.ai/mcp"
    headers:
      "Authorization": "Bearer ${THEDESIGNAGENT_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${THEDESIGNAGENT_TOKEN}. The registry never accepts secret values.

Quality 92 / 100strong

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorization83 · weight 15
  • pass
    auth.prmProtected Resource Metadata (RFC 9728) published
  • pass
    auth.as_metadataauthorization server metadata reachable
  • warn
    auth.cimdonly Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene93 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations3 of 3 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 1,242 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changes3 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @thedesignagent/[email protected]

3 tools, about 1,242 tokens to load them all · tool set 2bc462235050 · tools last changed 2026-10-04 · checked 2026-10-19 10:52 UTC

Tool changes

  • Visualchangedtitle, output schema, annotations
  • Uxchangedtitle, input schema, output schema, annotations
  • Discoverchangedtitle, output schema, annotations

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository
provenance55
liveness100
freshness100
hygiene80

+dns-namespace +website +reachable +uptime-100% +updated-13d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@thedesignagent/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://www.thedesignagent.ai/mcp streamable-httpoauth2 AS: https://bxqifcmkydlsgwgcpqda.supabase.co/auth/v1yes100%298 ms–2026-10-19
packageregistryversionruntimesecrets
@thedesignagent/mcpnpm0.5.3–THEDESIGNAGENT_API_KEY

Tools (3)

DiscoverGet a build brief calibrated to your project, persona, and the specific screen you're building. Call this BEFORE building any screen. Returns: - The active Job-to-be-Done for the task - Relevant heuristics, cognitive guidance, and patterns from the corpus - A focused build brief (~600 tokens) to inject into your build context CALL LIFECYCLE: - First call for a new project (no project_id): returns _meta.tda_status='setup_required' with an extraction task. Scan the repo's schema/types/migrations (or, with no repo, ask the user for a short product description as the task explains) and resubmit with project_model populated. - Subsequent calls: send ONLY task + project_id. project_model is cached server-side from the first call; resending it wastes ~2–4k tokens per call and re-runs validation. Resend project_model ONLY when a response returns _meta.tda_status='setup_required' or 'model_stale'. Use project_id from .thedesignagent or memory across calls. Pass repo_hash (SHA256 of git remote origin URL) only as a fallback if no project_id is known yet.
UxEvaluate a built UI artifact for JTBD fit, heuristic compliance, cognitive load, and pattern conformance. Call this AFTER building a screen. TheDesignAgent scores: - Heuristics: violations against Nielsen's heuristics + project-specific anti-patterns - Cognitive: load profile against the stored persona - Patterns: conformance to established project pattern decisions - JTBD fit: does the artifact serve the resolved job? Returns ux_score (0–10) + findings + prioritised recommendations. Stores new anti-patterns to project context — future builds benefit automatically.
VisualEvaluate a built UI artifact for visual design quality — brand compliance, visual cognitive load, and aesthetic quality. Pass render_url to review a real screenshot. This hosted server screenshots public pages and preview deploys (pass vercel_bypass_token for a protected Vercel preview). It cannot reach localhost or private networks: for those, it returns instructions for the local MCP server. With no render_url, the review runs from the artifact code alone. If the page redirects to login, no review runs and nothing is charged.

Schemas: list_tools.

Similar MCP servers

  • UseragentR0
    io.github.pipeworx-io/useragent

    User-Agent parser MCP.

  • Plug and ShipR0quality 81
    dev.plugandship/plugandship-mcp

    Search MCP servers, agent skills and coding-agent plugins: trending tools and best-of lists.

  • yad-agent-mcpL0
    io.github.holistis/yad-agent-mcp

    MCP wrapper for Yad, a local browser-automation companion, for coding agents.

  • Identity ForgeL0
    io.identityforge/mcp

    Design kits, brand naming, and domain research for coding agents.

  • brandpilot-mcpR1
    dev.brandpilot/brandpilot-mcp

    BrandPilot design systems for coding agents: tokens, design handoff bundle, prompt pack, import.

  • Design Pattern MCPL0
    io.github.olk/design-pattern-mcp

    MCP server that provides design-pattern selection expertise to AI coding agents

Official server.json
{
  "name": "ai.thedesignagent/mcp",
  "title": "TheDesignAgent",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://www.thedesignagent.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional: Bearer tda_... API key, for CI and headless use. Without it, clients that support MCP authorization sign in with OAuth."
        }
      ]
    }
  ],
  "version": "0.5.3",
  "packages": [
    {
      "version": "0.5.3",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@thedesignagent/mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "THEDESIGNAGENT_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "Your TheDesignAgent API key (starts with tda_)"
        },
        {
          "name": "CHROME_PATH",
          "description": "Browser binary for Visual screenshots, if not found automatically"
        }
      ]
    }
  ],
  "websiteUrl": "https://www.thedesignagent.ai",
  "description": "A design agent in your coding agent's loop: briefs each screen, reviews UX and visual quality."
}