AI Agent access

InkDoo has a public REST API, a command-line tool, and an MCP server. Create an API key in the dashboard, then plan an article, generate each shot, and poll the job. Planning is free. Signup includes 2 free images. 1 credit = 1 image. Generation runs in the background and can take minutes — there is no instant generate endpoint. Buying credits stays on the website. Markdown docs at /llms.txt are still there if you only need product context.

Create an API key

Available now

Sign in, open Settings → API keys, and create a key. Send it as Authorization: Bearer sk_… (or X-Api-Key). A key can call the product APIs; it cannot list or create other keys. Checkout stays on the website.

$curl -sS https://inkdoo.app/api/inkdoo/me -H "Authorization: Bearer $INKDOO_API_KEY"
$npx inkdoo me

Setup by tool

  1. 1

    In a terminal, save the docs or let Claude Code fetch this URL:

    $curl -sL https://inkdoo.app/llms.txt -o inkdoo-docs.md
  2. 2

    Then say: “Read the InkDoo docs and help me plan illustrations for this article. I’ll generate them at inkdoo.app/app.”

Then just ask

「Use the InkDoo API (key from /settings/apikeys) or MCP to plan illustrations for this article, then generate each shot and poll the job. 1 credit = 1 image; generation can take minutes.」

Docs are free to read. Sign up for 2 free images in the app. Start free — 2 images on us →

What your agent can do

✦

Call the API or CLI

Plan an article, start each shot, and poll the background job with the REST API, `npx inkdoo`, or MCP. 1 credit = 1 image.

「Plan this article and generate shot 0, then wait for the job.」

✦

Help plan scenes

Suggest which ideas deserve a picture and what each scene could show — then submit the plan through the API or confirm it in the app.

「Which paragraphs in this draft should get a doodle, and why?」

✦

Pick a character

Recommend Mochi, Doo, Blot, Stub, Folio, Puff, or a custom character you describe.

「I want a sleepy cat blob as the star — is that Mochi?」

✦

Stay accurate on price

Remind you that planning is free, signup includes 2 images, and 1 credit = 1 illustration. Buy credits on the website.

「How many free images do I get, and what do packs cost?」

More ways to connect

MCP

Use the stdio server with `npx inkdoo mcp`, or the remote endpoint https://inkdoo.app/mcp (JSON-RPC over POST, Authorization: Bearer sk_…). Tools map 1:1 to the REST API. 1 credit = 1 image; generation is async and can take minutes.

${ "mcpServers": { "inkdoo": { "command": "npx", "args": ["-y", "inkdoo", "mcp"], "env": { "INKDOO_API_KEY": "sk_..." } } } }

CLI

Install or run with `npx inkdoo`. Set INKDOO_API_KEY. Commands wrap the real endpoints: me, credits, import, plan, generate, job, sessions. `inkdoo generate --job <id> --index N` starts one planned shot (1 credit) and returns immediately; poll with `inkdoo job <id> --wait`.

$npx inkdoo plan --article-file article.md
Want a project file? Manual setup (two lines)

Open a terminal, save the docs next to your article, then tell your agent to read the file.

$curl -sL https://inkdoo.app/llms-full.txt -o inkdoo-docs.md
$ls inkdoo-docs.md

API keys and credits

Create a key at https://inkdoo.app/settings/apikeys and send Authorization: Bearer sk_…. Planning is always free. New accounts get 2 free images. 1 credit = 1 image. One-time packs: $4.99/40, $12.99/100, $29.99/250 (never expire). Subscriptions: $9.9/month for 120, $24.9/quarter for 400, $79/year for 1800 (unused subscription credits expire at period end). Failed generations are refunded. Buy credits on the website.

  1. 1

    Sign in and open Settings → API keys to create a key (sk_…).

  2. 2

    Set INKDOO_API_KEY, or pass Authorization: Bearer sk_… / --api-key. Signup already includes 2 free images.

  3. 3

    Plan is free. Each generate call deducts 1 credit, returns immediately, and can take minutes — poll GET /api/inkdoo/jobs/:id. When you need more credits, buy a pack or subscribe on Pricing.

REST API

Authenticate with Authorization: Bearer sk_… (or X-Api-Key). Cookie sessions still work on the website and remain same-origin. Typical flow: POST /api/inkdoo/plan (or /import) → POST /api/inkdoo/generate for each shot (1 credit, async) → GET /api/inkdoo/jobs/:id until succeeded. Also: GET /api/inkdoo/me, GET /api/credits, GET /api/inkdoo/sessions/. Checkout is not a CLI payment API.

Authorization: Bearer sk_...
GET  https://inkdoo.app/api/inkdoo/me
POST https://inkdoo.app/api/inkdoo/plan
POST https://inkdoo.app/api/inkdoo/generate
GET  https://inkdoo.app/api/inkdoo/jobs/:id
Docs: https://inkdoo.app/llms.txt

FAQ

Does it cost anything?

Reading the docs is free. Planning in the app is free. You get 2 images on signup; further images use credits (packs or a subscription). See Pricing.

Is there an MCP or npx install?

Yes. Run `npx inkdoo` for the CLI, `npx inkdoo mcp` for local MCP, or connect Cursor/Claude to https://inkdoo.app/mcp with your API key. Fetch /llms.txt or /skill.md for product context.

Can the agent draw the pictures?

Yes, through the official API: plan first, then generate each shot and poll the job. Each image costs 1 credit and can take minutes. Images you generate are yours to use in your articles, newsletters and products (don’t prompt for other people’s trademarks).

What about the meme library?

The meme library is on /memes. You can browse and search the first-screen collections there. It is separate from hand-drawn article illustrations, which still run through /app.