5D Painting

Developers

Your own tools and AI assistants

With the Pro or Studio plan, AI assistants such as Claude Code or Cursor, and programs you write, can work with your cloud projects and make new patterns from pictures. Whatever they make opens in the studio from File > Open from Cloud.

1. Create an API key

On your account page, under API keys, name a key after what will use it and choose Create key. Copy the key then: it starts with p5d_ and is shown only once. Keep it like a password. Revoking it on the same page stops it at once.

2. Connect an AI assistant

5D Painting is an MCP server at https://p5d-api.notallow.cc/mcp. In Claude Code:

claude mcp add --transport http p5d https://p5d-api.notallow.cc/mcp \
  --header "Authorization: Bearer p5d_…"

In Cursor and other assistants that read an mcp.json:

{
  "mcpServers": {
    "p5d": {
      "url": "https://p5d-api.notallow.cc/mcp",
      "headers": { "Authorization": "Bearer p5d_…" }
    }
  }
}

Then ask in your own words, such as “make a 150-stone pattern of this photo with 30 colours” or “which threads does my Garden pattern need?”. The assistant can:

account_status
your plan, cloud storage, and patterns left today
list_projects
your cloud projects
get_pattern
a pattern’s size and every thread with its code, name and stone count
preview_pattern
a picture of a pattern
create_pattern
a new pattern from an image it has, or from a public https address
rename_project
a new name for a project
delete_project
deletes a project; assistants ask you first

3. Or call the API yourself

Send the key as Authorization: Bearer p5d_…. Your projects:

curl -H "Authorization: Bearer $P5D_KEY" https://p5d-api.notallow.cc/v1/projects

A new pattern from a picture. width is in stones; height, colours, catalog (dmc, anchor or sulky) and style (photo or illustration) are optional:

curl -H "Authorization: Bearer $P5D_KEY" \
  --data-binary @photo.jpg \
  "https://p5d-api.notallow.cc/v1/patterns?name=Garden&width=120&colours=24&style=photo"

A pattern’s threads, a preview, and the project file the studio opens:

curl -H "Authorization: Bearer $P5D_KEY" https://p5d-api.notallow.cc/v1/projects/$ID/summary
curl -H "Authorization: Bearer $P5D_KEY" -o preview.png https://p5d-api.notallow.cc/v1/projects/$ID/preview.png
curl -H "Authorization: Bearer $P5D_KEY" -o garden.p5d https://p5d-api.notallow.cc/v1/projects/$ID

Errors come back as JSON with a code and a message to show people.

Limits