Skip to main content
skill CX Codex

visant-mcp-connect — Claude Code skill: setup and features

visant-mcp-connect is a Claude Code skill that connects the agent to Visant Labs over MCP. It activates for requests to set up Visant, use its tools, or extract information from a PDF.

MIT ★ 91 updated 2026-11-11

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code
Open on GitHub

What visant-mcp-connect does

The skill configures access to the Visant Labs MCP server. Its tools cover brand guidelines, mockups, budgets, moodboards and canvases, along with PDF extraction.

A Visant Labs account is required; anonymous access is unavailable. Generation uses account credits. In Claude Code, the server is added with claude mcp add at https://api.visantlabs.com/api/mcp. The tools appear in the next session under the mcp__visant__ prefix.

What it helps with

  • connect an agent to the Visant Labs MCP server
  • create or revise brand guidelines
  • generate a mockup from a prompt
  • extract brand tokens from a PDF

Example prompts for the agent

  • Connect Visant Labs and configure its tools in Claude Code.
  • Use Visant to revise the brand guidelines.
  • Extract information and brand tokens from this PDF with Visant.

How to install visant-mcp-connect

1Skills CLI (Vercel)

npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code

2Manually: put the files in place

~/.claude/skills/visant-mcp-connect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/visant-mcp-connect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about visant-mcp-connect

How do I install visant-mcp-connect in Claude Code?

Run npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code. The skill file is placed at ~/.claude/skills/visant-mcp-connect/SKILL.md.

What does visant-mcp-connect do?

It connects Claude Code to Visant Labs through MCP. The service tools handle brand guidelines, mockups and budgets, and can extract content from PDFs.

What does visant-mcp-connect require?

A Visant Labs account is required. Generation consumes account credits.

Source text

SKILL.md · MIT
---
name: visant-mcp-connect
description: 'Connects and operates the Visant Labs MCP (requires a Visant Labs account): brand guidelines, mockups, creative studio, canvas, budgets, moodboard, PDF extraction. Use on "connect visant", "use the visant tools", "setup visant mcp", "conecta o visant", "usar as tools do visant", "extrair PDF pelo visant".'
tags:
  - mcp
  - visant
  - brand
  - ai-tools
metadata:
  family: marca
---

# Visant Labs MCP

> **Requires a Visant Labs account** (visantlabs.com). Without one, none of these
> tools work: there is no anonymous mode. Generation tools also spend the
> account's credits.

**API:** `https://api.visantlabs.com`
**MCP:** `https://api.visantlabs.com/api/mcp`
**Auth:** OAuth 2.1 + PKCE (dynamic client registration) or API key (`visant_sk_...`)

---

## Connect (Claude-first flow)

### Step 1: check for existing credentials

```bash
cat ~/.visant/credentials.json
```

If it exists and has `apiKey`, skip to Step 3.

### Step 2: authenticate

Ask the user for their Visant Labs email and password, then run:

```bash
npx visantlabs login -e EMAIL -p PASSWORD
```

This saves `~/.visant/credentials.json` with the permanent `apiKey`
(`visant_sk_...`).

### Step 3: configure the MCP (global, any directory)

```bash
claude mcp add --transport http \
  --header "Authorization: Bearer <apiKey>" \
  --scope user \
  visant https://api.visantlabs.com/api/mcp
```

> **Do not use** `mcpServers` in `settings.json` or `mcp-remote`: the server
> speaks Streamable HTTP directly.

### Step 4: verify

```bash
claude mcp list
# should show: visant: https://api.visantlabs.com/api/mcp (HTTP) - ✓ Connected
```

The tools show up with the `mcp__visant__` prefix in the next session.

---

## Available tools (~50)

### Account & Auth
| Tool | What it does |
|------|-----------|
| `account-profile` | User profile (name, email, plan) |
| `account-usage` | Remaining credits, limits, billing cycle |
| `auth-login` | Email/password login → JWT |
| `auth-register` | Create account → JWT |
| `api-key-create` | Generate a `visant_sk_xxx` API key |
| `api-key-list` | List existing API keys |

### Brand Guidelines (16 tools)
| Tool | What it does |
|------|-----------|
| `brand-guidelines-list` | List all brand guidelines |
| `brand-guidelines-get` | Full data (JSON, or `format:"prompt"` for LLM-ready text) |
| `brand-guidelines-create` | Create a new guideline |
| `brand-guidelines-update` | Partial patch (colors, typography, strategy, tokens) |
| `brand-guidelines-delete` | Delete (requires `confirm: true`) |
| `brand-guidelines-duplicate` | Duplicate a guideline |
| `brand-guidelines-share` | Create/revoke a public link |
| `brand-guidelines-public` | Access by slug (no auth) |
| `brand-guidelines-ingest` | Extract from URL/text and merge into the guideline |
| `brand-guidelines-compliance-check` | AI audit (contrast, typography, voice, completeness) |
| `brand-guidelines-versions` | Version history |
| `brand-guidelines-restore-version` | Restore a previous version |
| `brand-guidelines-upload-logo` | Upload logo (base64/URL, variants: primary/dark/light/icon) |
| `brand-guidelines-upload-media` | Upload media kit (image/PDF) |
| `brand-guidelines-delete-logo` | Delete logo by ID |
| `brand-guidelines-delete-media` | Delete media by ID |

### Branding Machine (5 tools)
| Tool | What it does |
|------|-----------|
| `branding-generate` | Generate a visual identity from a prompt (steps: full/market-research/swot/persona/archetype/concept-ideas/color-palettes/moodboard). Follows `visant-methodology` |
| `branding-list` | List branding projects |
| `branding-get` | Project details |
| `branding-save` | Save/update a project |
| `branding-delete` | Delete a project |

### Mockup Machine (5 tools)
| Tool | What it does |
|------|-----------|
| `mockup-generate` | Generate an AI mockup. Models: `gpt-image-2` (best), `gemini-3.1-flash-image-preview`, `seedream-3-0`. Resolutions: 1K/2K/4K. Aspect ratios: 1:1/16:9/9:16/4:5. Auto-injects brand context via `brandGuidelineId`. |
| `mockup-list` | List mockups |
| `mockup-get` | Mockup details |
| `mockup-update` | Update metadata |
| `mockup-delete` | Delete |
| `mockup-presets` | Presets by category (business-card, social-media, packaging, apparel, etc.) |

### Creative Studio (8 tools)
| Tool | What it does |
|------|-----------|
| `creative-full` | Full pipeline: plan → background → render PNG → save. One shot. |
| `creative-generate` | Generate a structured layout (layers, overlay, background prompt) |
| `creative-render` | Render a plan to PNG server-side |
| `creative-projects-create` | Save a creative project |
| `creative-projects-list` | List projects |
| `creative-projects-get` | Project details |
| `creative-projects-update` | Update a project |
| `creative-projects-delete` | Delete a project |

### Canvas / Whiteboard (8 tools)
| Tool | What it does |
|------|-----------|
| `canvas-create` | Create a whiteboard |
| `canvas-list` | List projects |
| `canvas-list-projects` | List with a summary of node types |
| `canvas-get` | Details (nodes, edges, drawings) |
| `canvas-update` | Update nodes/edges/linkedGuideline |
| `canvas-delete` | Delete |
| `canvas-share` | Share (canEdit/canView by email) |
| `canvas-parse-csv` | Preview CSV → DataNode rows |
| `canvas-resolve-variables` | Resolve `{{placeholders}}` in a prompt |

### Budget (6 tools)
| Tool | What it does |
|------|-----------|
| `budget-create` | Create a budget (clientName, projectDescription) |
| `budget-list` | List budgets |
| `budget-get` | Details with line items |
| `budget-update` | Update fields |
| `budget-delete` | Delete |
| `budget-duplicate` | Duplicate |

### AI Utilities (free)
| Tool | What it does |
|------|-----------|
| `ai-describe-image` | Describe an image (URL or base64). 0 credits. |
| `ai-improve-prompt` | Improve prompt text. 0 credits. |

> **House rule: a generated prompt is a saved prompt.** Every call to
> `ai-generate-image` / `creative-generate` / `mockup-generate` / `video-generate`
> goes to the project's `prompts.jsonl` ledger: one line per call, with
> model/params, refs **with each one's role**, `sha256` of the output, status
> (approved/discarded), cost, and a note on what went wrong for discarded ones.
> Record it on the spot: it cannot be recovered later. If `visant-mockup-creator`
> is installed, the contract is in its `references/prompt-ledger.md`.

### Document & Image Extraction
| Tool | What it does |
|------|-----------|
| `document-extract` | **Dual mode**, see "Document Extract" below. URL mode pulls HD images from any public page; PDF mode turns a PDF into markdown + brand tokens. |

### Moodboard (3 tools)
| Tool | What it does |
|------|-----------|
| `moodboard-detect-grid` | Detect bounding boxes in a moodboard grid |
| `moodboard-suggest` | Suggest animations/video for each cell |
| `moodboard-upscale` | Upscale an image to 1K/2K/4K. **⚠ Unstable: returned `INTERNAL_ERROR` on 3/3 calls in Aug 2026.** See "When a tool goes down". |

### Community (2 tools)
| Tool | What it does |
|------|-----------|
| `community-presets` | Browse public mockup presets |
| `community-profiles` | Browse community profiles |

---

## When a tool goes down

MCP tools break, and the right response is never to insist or to pretend the
result came out:

1. **Two attempts, no more.** Repeated `INTERNAL_ERROR` is the server, not the
   payload; a third try only burns time.
2. **Use the alternative and say which one.** Never swap silently: whoever reads
   the result needs to know which path it came through.
3. **Report the breakage** in the work's `.md`, with the date and the exact
   message.

| If it fails | Alternative |
|---|---|
| `moodboard-upscale` | Look for the high-res ORIGINAL before upscaling: it almost always exists and nobody looked (run [[visant-preflight]]). Upscaling is plan B; upscaling without searching for the original is plan C dressed as plan A. |
| `ai-generate-image` falls back to the wrong model | The response carries `fellBack: true` and the real `model`. **Read the response**: asking for gemini and getting gpt-image-1 changes the result and the cost. |
| `brand-guidelines-health-check` | Do not trust it; confirm with `brand-guidelines-get`. It has reported an empty vault on a full one. |
| Local file upload | `visant upload <file> --json` via the CLI, or a presigned URL (`media-upload-urls` + `curl -X PUT` + `media-commit`). Inline base64 truncates and uploads a corrupted image. |

---

## Document Extract (dual mode)

### Mode 1: image extraction from a URL
```json
{ "url": "https://www.behance.net/gallery/...", "limit": 80 }
```
Returns image URLs with width, height and alt text (`limit` max 200). Works with
Behance, Pinterest, Dribbble, portfolios, blogs. Handles lazy-loaded images,
srcset and background images. Scope: `read`.

### Mode 2: PDF extraction
```json
{ "pdf_base64": "<base64>", "output": "inline", "include_brand_tokens": true }
```
Also accepts `pdf_path` for files on the server. `output: "disk"` saves a `.md`,
`"inline"` returns text. `include_brand_tokens: true` extracts colors, typography
and strategy (two phases: algorithmic + Gemini).

---

## Expired token / 401

```bash
cat ~/.visant/credentials.json   # take .apiKey
```

Update the Bearer in the MCP config and restart the session. If the file does not
exist: `npx visantlabs login`.

---

## Usage tips

- **Brand context in generation:** pass `brandGuidelineId` to mockup-generate,
  creative-full and creative-generate to inject colors/typography/voice.
- **`format: "prompt"`** on `brand-guidelines-get` returns text optimized for LLM
  context, not JSON.
- **creative-full** is the shortcut: it avoids chaining generate + mockup-generate
  + render by hand.
- **Credits:** `account-usage` shows the balance. AI utilities (describe-image, improve-prompt) are free.
- **Scopes:** OAuth tokens enforce `read`, `write`, `generate`; generation tools
  need `generate`.

## Neighbors

- **[[visant-brand-populate]]**: fill a new brand
- **[[visant-brand-sync]]**: reconcile an existing brand
- **[[visant-methodology]]**: the method behind the fields
- **[[visant-creative]]**: social and marketing pieces
- **[[brand-mockup-kit]]**: a batch of mockups for a brand
- **[[visant-mockup-creator]]**: new scene photos for the store

© pedrojaques99 · MIT · pedrojaques99/visant-skills-public

Similar skills

All skills for Design →

From the same set12

The whole set →
visant-methodology visant-methodology is a Claude Code skill that builds brand strategy through a 9-stage cascade across 3 phases. Triggers on requests for brand audits, messaging frameworks, or full identity setups. CX Codex +1 ★ 91repo stars visant-design visant-design is a Claude Code skill that redesigns interfaces and checks the result against the running app. It activates for UI/UX improvements, screen redesigns, or requests to remove generic AI styling. CX Codex +1 ★ 91repo stars site-reels site-reels is a Claude Code skill that records scripted site interactions into 1080p MP4 videos for Figma Slides and product reels. CX Codex +1 ★ 91repo stars visant-preflight visant-preflight is a Claude Code skill that runs a stakeholder questionnaire and validates brand assets, fonts, and images before new site builds or redesigns. CX Codex +1 ★ 91repo stars visant-video-editor visant-video-editor is a Claude Code skill that turns raw footage into an edited video by preparing a cut list and assembling approved cuts. It activates for requests to edit a vlog, lesson, or silence in a recording. CX Codex +1 ★ 91repo stars visant-premiere-editor visant-premiere-editor is a Claude Code skill that builds rough cuts in Adobe Premiere Pro from a JSON plan. It transfers timelines through FCP7 XML and MCP without dropping frames. CX Codex +1 ★ 91repo stars visant-refine visant-refine is a Claude Code skill for styling charts, gauges, sparklines, and control panels as parts of one interface. It activates for requests to add a chart, build a simulator slider, or polish a screen. CX Codex +1 ★ 91repo stars visant-copy visant-copy is a Claude Code skill that writes and audits pt-BR copy in Visant's voice, with a linter for AI tics in PT and EN. It fires on requests about headlines or tone of voice. CX Codex +1 ★ 91repo stars

Project sponsors

Companies that keep this analytics open