# Install SciDraw AI (MCP) — guide for AI agents

SciDraw AI makes publication-ready scientific figures, data charts and editable
PPTX/SVG files. This guide tells an AI agent how to connect it as an MCP server.

- MCP server: `https://sci-draw.com/api/mcp` (Streamable HTTP, OAuth sign-in in the browser)
- Server name in configs: `scidraw-ai`
- Plugin repo: https://github.com/TopLocalAI/scidraw-plugins

## Rules for the agent

1. Install only because the user asked you to. Do not change unrelated settings.
2. Detect what your host supports (plugins, `mcp add` commands, config files,
   or none) and use the first matching section below.
3. Sign-in is OAuth in the user's browser. Never ask for a password, API key or
   token, and never paste one into a config file.
4. Verify without spending credits: confirm the user is signed in and that the
   SciDraw AI tools are listed. Calling `get_credit_balance` is free.
5. Do not generate an image during setup.
6. Report only what you observed (installed, signed in, tools found, balance).
   If a step failed or you could not check it, say so.

## Codex (CLI, or Codex in the ChatGPT desktop app)

With plugin support:

```sh
codex plugin marketplace add TopLocalAI/scidraw-plugins --ref main
codex plugin add scidraw-ai@scidraw-marketplace
```

Then authorize. If the host lists an MCP server named `scidraw-ai`, run
`codex mcp login scidraw-ai`; otherwise ask the user to click Connect on SciDraw AI
in the app and sign in. Then check that the tools are available.

Without plugin support:

```sh
codex mcp add scidraw-ai --url https://sci-draw.com/api/mcp
codex mcp login scidraw-ai
```

## Claude Code

```text
/plugin marketplace add TopLocalAI/scidraw-plugins
/plugin install scidraw-ai@scidraw-plugins
```

Fallback without plugins:

```sh
claude mcp add --transport http scidraw-ai https://sci-draw.com/api/mcp
```

Then ask the user to run `/mcp`, choose `scidraw-ai` and sign in in the
browser. New tools may need a new session to appear.

## Claude.ai, Claude desktop, ChatGPT web

You cannot add connectors here yourself. Give the user these steps:

- Claude: Settings → Connectors → Add custom connector. Name `SciDraw AI`,
  URL `https://sci-draw.com/api/mcp`, click Add, then Connect and sign in.
- ChatGPT: Settings → Apps & Connectors → Advanced settings → turn on Developer
  mode. Then Apps & Connectors → Create, name `SciDraw AI`, URL
  `https://sci-draw.com/api/mcp`, OAuth, and sign in. Enable it in a new chat's tools menu.

Menu names change from time to time; some workspaces block custom connectors.

## Cursor

Merge into `~/.cursor/mcp.json` (keep existing servers):

```json
{
  "mcpServers": {
    "scidraw-ai": {
      "url": "https://sci-draw.com/api/mcp"
    }
  }
}
```

Then sign in from Cursor Settings → MCP when prompted.

## After setup: short first-run intro

In the user's language, without generating anything, tell them in a few lines:
they are connected (and their balance, if you checked it), what they can ask
for, and one example request, such as "Draw a graphical abstract of
exosome-mediated miR-21 transfer, flat style, white background".

## Facts

Tools:

- `generate_figure` — figure from a text description (2K or 4K, up to 4 images)
- `edit_figure` — change an existing figure from an image URL
- `convert_figure` — to SVG, PPTX, PNG, PDF or TIFF
- `generate_chart` — data chart from CSV or table rows
- `get_job` — status and result of a running job (free)
- `get_credit_balance` — the user's credit balance (free)

Credits come from the user's SciDraw AI balance, at the same prices as the website:

| Operation | Credits |
| --- | --- |
| Generate, 2K / 4K | 5 / 20 per image |
| Edit, 2K / 4K | 10 / 20 per image |
| Chart | 10 |
| SVG (full vector, editable text) | 10 |
| PPTX | 10 |
| PNG, PDF or TIFF at 300 / 600 / 1000 DPI | 5 / 10 / 15 |

- Failed jobs are refunded automatically.
- A call waits up to 50 seconds. If the job is still running,
  poll `get_job` with the returned job ID. Never re-send a creation call for the
  same request: that starts a new job and charges again.
- Check generated figures for scientific accuracy (labels, structures,
  numbers) before the user publishes them.

Links: web app https://sci-draw.com/ai-drawing · pricing https://sci-draw.com/pricing · setup page
https://sci-draw.com/mcp · support contact@sci-draw.com
