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/projectsA 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/$IDErrors come back as JSON with a code and a message to show people.
Limits
- Patterns made from pictures: 20 a day with Pro, 100 with Studio. Requests that fail are not counted.
- Pictures up to 10 MB; patterns 10 to 400 stones wide and up to 600 tall, with 2 to 50 colours.
- Up to 5 keys per account, each making up to 60 requests a minute.
- Patterns count toward your plan’s cloud projects and storage.
- Keys stop working when the plan ends, and start again when it is renewed.