Quickstart

This guide connects an AI client to Pink Editor and walks through the first calls of a session. You need a Pink Editor account (app.edit.pink); new accounts start with 1,000 credits.

1. Connect your client

Pick the line for your client. Each one signs you in on first use, with nothing to paste and nothing to keep secret. To use an API key instead, see Authentication.

Cursor:

{
  "mcpServers": {
    "pink": { "url": "https://app.edit.pink/api/mcp" }
  }
}

Windsurf (and Claude Desktop, if you prefer a config file to the .dxt):

{
  "mcpServers": {
    "pink": {
      "command": "npx",
      "args": ["-y", "@editpink/mcp"],
      "env": { "EDITPINK_API_URL": "https://app.edit.pink" }
    }
  }
}

The signed-in Connect page shows the same snippets, ready to copy. Every client setup is covered in Connect a client.

2. Check it works

Ask your AI: "List my Pink sites." The model calls list_sites and shows each site's id and domain. With the stdio bridge, the first call opens a browser tab to approve a code; approve it, then ask again.

No site yet? Ask it to create one. It calls add_site with your domain, and you become the site's owner.

3. Start a session

Every session begins the same way. Pink's server instructions tell the model to do this on its own, but it helps to know the order:

1. list_sites: the sites you can work on.
2. select_site with a site_id: binds the site and returns its foundation (brand, audiences, goals, calls to action).
3. get_skill with name: "pink-core": loads Pink's operating playbook, which covers publishing, tool choice and undo.

Clients that support prompts also offer a pink prompt (shown as /pink in Claude Desktop) that starts this for you.

4. Do something useful

Try one of these:

• "What pages have no internal links pointing at them?": graph with predicate: "orphans". Free.
• "Pull keyword volumes for sailing holidays, yacht charter, boat rental.": get_keywords. 1 credit.
• "Research what people say about first-time charters on Reddit.": research in reddit mode. 10 credits, takes 30 to 60 seconds.
• "Write and publish the page on charter costs.": add_article. Writing and publishing are free; questions researched during the run are billed as research. See Credits.

Changed something you didn't want? Ask the model to undo it: undo reverses the last call or the last turn.

What's next

• Authentication: OAuth, API keys and site roles.
• Sessions and publishing: how a session binds a site, and how add_article runs.
• Tool reference: every tool with its input schema.
• Credits and pricing: what costs what.