{
  "markdown": "# DesignForYou — MCP server\n\n[![npm](https://img.shields.io/npm/v/designforyou-mcp?logo=npm)](https://www.npmjs.com/package/designforyou-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-designforyou-2ea44f)](https://registry.modelcontextprotocol.io/v0/servers?search=designforyou)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n\nGenerate **logos, social posts, app-store screenshots, comic panels, and\nvisual-novel assets** from natural-language prompts — directly inside Claude\nCode, Grok, Codex, Cursor, OpenCode, ChatGPT, or any MCP client.\n\nDesignForYou is an MCP-native design generator backed by 119 templates. Browse\nand recommend tools are free; generation is metered per user (50 free credits on\nsign-up).\n\n## Demo\n\n![DesignForYou demo — prompt to generated design](./demo.gif)\n\n*Describe what you want → the agent picks a template and generates a finished\ndesign. Logos, Instagram posts, app-store screenshots, and more.*\n\n| | |\n|---|---|\n| **Website** | https://designforyou.swapp1990.org |\n| **Connect (human)** | https://designforyou.swapp1990.org/connect |\n| **Agent guide (plain text)** | https://designforyou.swapp1990.org/.well-known/mcp/connect.md |\n| **MCP URL** | `https://designforyou.swapp1990.org/mcp/v2/` (trailing slash required) |\n| **Privacy** | https://designforyou.swapp1990.org/privacy |\n\n## Auth\n\n| Path | What you do | Who stores secrets |\n|------|-------------|--------------------|\n| **OAuth (primary)** | Complete browser sign-in when the client prompts | **The MCP client** |\n| **Long-lived token (fallback)** | Sign in on the website → Generate on `/connect` → `DESIGNFORYOU_MCP_TOKEN` | **You** (env / header) |\n\nOAuth is the normal path. PAT minting is only for Codex, headless agents, or when OAuth stays “disabled / not connected.” Full recipes: [CONNECT.md](./CONNECT.md) or the live well-known guide above.\n\n## Install\n\n### Claude Code (recommended)\n\n```bash\nclaude mcp add --transport http designforyou https://designforyou.swapp1990.org/mcp/v2/\nclaude mcp login designforyou\n```\n\nApprove the browser sign-in when prompted.\n\n### Grok\n\n```bash\ngrok mcp add --transport http designforyou https://designforyou.swapp1990.org/mcp/v2/\n```\n\nThen `/mcps` → `designforyou` → `i` (authorize) → browser → `r`.\n\n### OpenCode\n\nAdd a remote MCP entry for the URL above, then:\n\n```bash\nopencode mcp auth designforyou\nopencode mcp list\n```\n\n### Codex (bearer fallback)\n\n1. Generate a token at https://designforyou.swapp1990.org/connect  \n2. Store as `DESIGNFORYOU_MCP_TOKEN`  \n3. Configure:\n\n```powershell\ncodex mcp add designforyou --url https://designforyou.swapp1990.org/mcp/v2/ --bearer-token-env-var DESIGNFORYOU_MCP_TOKEN\n```\n\n### Cursor\n\n[![Add to Cursor](https://img.shields.io/badge/Add%20to-Cursor-000?logo=cursor)](cursor://anysphere.cursor-deeplink/mcp/install?name=designforyou&config=eyJ1cmwiOiJodHRwczovL2Rlc2lnbmZvcnlvdS5zd2FwcDE5OTAub3JnL21jcC92Mi8ifQ==)\n\nOr `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"designforyou\": {\n      \"url\": \"https://designforyou.swapp1990.org/mcp/v2/\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\n### VS Code\n\n[![Install in VS Code](https://img.shields.io/badge/Install-VS%20Code-0098FF?logo=visualstudiocode)](https://insiders.vscode.dev/redirect/mcp/install?name=designforyou&config=%7B%22url%22%3A%22https%3A%2F%2Fdesignforyou.swapp1990.org%2Fmcp%2Fv2%2F%22%7D)\n\n### Claude Desktop / stdio shim\n\n```bash\nnpx -y designforyou-mcp\n```\n\nOr native HTTP in `claude_desktop_config.json` with the `/mcp/v2/` URL. Complete OAuth when prompted.\n\n### Optional local Grok CLI sidecar\n\nThe default command above always uses the hosted DesignForYou MCP server. To\nrun the focused local image and reference-animation tools instead, explicitly\nopt in with an installed, signed-in Grok Build CLI:\n\n```powershell\n$env:DESIGNFORYOU_PROVIDER = \"grok-subscription\"\nnpx -y designforyou-mcp\n```\n\nThis sidecar invokes `grok --single` through the CLI's existing signed-in\nsession; it never accepts or forwards an xAI API key, and it denies all MCP\ntools inside the spawned CLI so generation cannot route through a hosted\nbilling server. **Billing note:** the Grok Build CLI's native media tools\n(`image_gen`, `image_to_video`) call the xAI API (`api.x.ai`) with the\nsigned-in session token, so each generation meters the account's xAI console\nusage — media generation is not covered by the grok.com chat subscription.\nThe sidecar exposes `grok_generate_image` and `animate_reference_grok_video`,\nand verifies the requested local output file before returning it. The hosted\ntools and their providers remain the default when the variable is unset.\n(The `grok-subscription` opt-in value is kept for compatibility with existing\nclient configs.)\n\n#### Use the sidecar from local Codex threads\n\nRegister the checked-out sidecar as a local stdio MCP server:\n\n```powershell\ncodex mcp add designforyou-grok-local `\n  --env DESIGNFORYOU_PROVIDER=grok-subscription `\n  -- node D:\\MyProjects\\Claude\\designforyou-mcp\\bin.js\n\ncodex mcp list\n```\n\nRestart Codex or open a new local thread after adding the server. The thread\ncan then generate a starting frame with `grok_generate_image` and pass that\nfile to `animate_reference_grok_video` for an acting performance:\n\n```json\n{\n  \"image_path\": \"D:\\\\assets\\\\actor-scene.jpg\",\n  \"prompt\": \"She notices someone entering, freezes, then forces a nervous smile. Step backward slowly while maintaining eye contact. Use a subtle handheld push-in.\",\n  \"line\": \"I wasn't expecting you.\",\n  \"duration\": 6,\n  \"aspect_ratio\": \"16:9\",\n  \"output_path\": \"D:\\\\assets\\\\performance.mp4\"\n}\n```\n\nThe reference may be supplied as `image_path`, `image_url`, or\n`image_data_url`. This is a local-development path: the Codex host must be able\nto run the installed, signed-in `grok` executable. Codex cloud threads cannot\nuse the machine's Grok login or local files. Use only trusted prompts because\nthe sidecar runs Grok headlessly with automatic tool approval.\n\nFor video results, `public_url` is returned when Grok supplies a usable URL/key\nor when optional S3 correlation is configured. The sidecar brackets generation\nwith S3 listings and accepts only one newly-created object whose key is absent\nfrom the baseline and whose byte size exactly matches the verified local MP4;\nit also checks HTTP accessibility. S3 settings can be supplied with\n`DESIGNFORYOU_GROK_S3_BUCKET`, `DESIGNFORYOU_GROK_S3_REGION`,\n`DESIGNFORYOU_GROK_S3_ENDPOINT`, and `DESIGNFORYOU_GROK_S3_KEY_PREFIX`, or\ndiscovered from the narrowly-scoped\n`[tools.zdr_video_output_s3]` and its `.read_write` credentials section in\nthe local Grok config.\nMissing configuration, listing failures, ambiguous matches, and inaccessible\nobjects leave the verified local success intact and include a diagnostic.\nAutomatic correlation requires the AWS CLI on `PATH` and the local Grok S3\nconfiguration. The configured identity also needs `s3:ListBucket` restricted\nto the configured key prefix; upload-only `s3:PutObject` credentials cannot\nperform safe correlation. Credentials are passed only to the AWS child process\nand are never printed or packaged. If listing is unavailable, generation still\nreturns the verified local file with an explicit diagnostic.\n\n## Tools\n\n| Tool | Cost | What it does |\n|------|------|--------------|\n| `browse_templates` | free | Browse the 119-template catalog (filter by category) |\n| `recommend_template` | free | Recommend the best templates for a described use case |\n| `get_text_fields` | free | List a template's editable text fields |\n| `get_credits` | free | Check your credit balance |\n| `generate` | paid | Generate a finished design from a template + description |\n| `generate_variations` | paid | Generate style variations of a template |\n| `edit_text` | paid | Edit text on an existing design |\n| `vn_generate_sprite_sheet` | paid | Generate a visual-novel character sprite sheet |\n\n## Example prompts\n\n- *\"Browse logo templates on DesignForYou.\"*\n- *\"I'm opening a coffee shop called NEXUS — minimalist, warm earth tones. Make me a logo.\"*\n- *\"Generate an Instagram post announcing a 20%-off flash sale for a vegan bakery.\"*\n- *\"Create an app-store screenshot for a meditation app, calm gradient background.\"*\n\n## How it works\n\nDesignForYou exposes a remote MCP server (Streamable HTTP). On the first paid\ntool call (or when you run `mcp login` / `mcp auth`), your client discovers the\nOAuth flow (RFC 9728 protected-resource metadata → Supabase with Dynamic Client\nRegistration), opens a browser for sign-in + consent, and stores tokens.\nGeneration is metered against your credit balance; top up on the website.\n\nThis repository is the public home for install docs and the MCP `server.json`.\nThe product itself is a hosted service — there is no self-host package.\n\n## Links\n\n- App: https://designforyou.swapp1990.org  \n- Connect: https://designforyou.swapp1990.org/connect  \n- Agent guide: https://designforyou.swapp1990.org/.well-known/mcp/connect.md  \n- [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=designforyou) as `org.swapp1990.designforyou/designforyou`\n",
  "bytes": 9120,
  "sha": "da201c4c433503d1205be74661022aabdb231ea70883e1271d3cc1b6287ce2ae",
  "repo_slug": "swapp1990/designforyou-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_org_swapp1990_designforyou_designforyou_8d009140/readme"
}