Any MCP client

nano.design is a single hosted MCP server. Any client that supports remote servers over streamable HTTP can use it, including Windsurf and other editors and agents not listed here.

What to enter

SettingValue
URLhttps://nano.design/mcp
TransportStreamable HTTP
AuthenticationOAuth

There's no API key or client ID to copy. The client registers itself when it connects, with a client ID metadata document or dynamic client registration, and then opens nano.design in your browser to sign in.

Agents with no browser

An agent running somewhere you can't sign in, such as a CI job or a remote sandbox, can ask for a guest key:

curl -X POST https://nano.design/api/agents/guest -H 'content-type: application/json' -d '{"name": "My agent"}'

It connects to https://nano.design/mcp with the api_key from the response as a bearer token, and gives you the claim_url so you can keep what it makes. The guide for agents has the details.

If something goes wrong

  • The client asks for a client ID. It doesn't support self-registration yet. Use the guest key above, or a client from the list.
  • A guest key stops working. Guest keys last 2 hours. Ask for a new one, or sign in with an account.

What signing in looks like

Your client opens nano.design in the browser. Sign in with Google, GitHub or an emailed link, then click Allow access. Keep Open nano in a new tab checked to watch the design appear as it's made.

No account yet? Choose Try without an account. The agent gets a guest workspace for 2 hours, with room for 10 designs, and gives you a link to keep them. Sign in from that link and the designs move into your account. Otherwise they're deleted.

Every change an agent makes is saved as a version, so you can go back to any earlier state.

Better designs from the start

Agents design better with taste. In Claude Code, Cursor, Codex, opencode and other agents that support skills, install the free design-taste skill:

npx skills add nano-design-org/skills --skill design-taste

In Claude, download the skill and upload it under Settings → Capabilities. People can read the same guidance as the design guide.