# Bianca Beta Setup

Bianca is an agent-native creative director MCP. Your agent runs Bianca; your Higgsfield account renders the images/videos.

## Links

- Bianca page: https://fift.studio/bianca
- MCP endpoint: https://fift.studio/bianca/mcp
- Agent instructions: https://fift.studio/bianca/llms.txt
- Demo prompt: https://fift.studio/bianca/demo-prompt.txt

## What you need

1. An AI agent/client that supports MCP tools.
2. A Bianca MCP Access Key or OAuth connection.
3. Your own Higgsfield/generator account and credits.

FIFT does not spend generator credits for self-serve beta users by default.

## Connect Bianca

### Claude / ChatGPT / Grok hosted connectors

1. Add MCP server: `https://fift.studio/bianca/mcp`
2. Use OAuth if your host shows the login/authorization flow.
3. Start a fresh chat and paste the demo prompt.

### Hermes / OpenClaw / Cursor / manual MCP clients

Store the key as a connector header, not in chat:

```yaml
mcp_servers:
  bianca:
    url: https://fift.studio/bianca/mcp
    enabled: true
    headers:
      Authorization: "Bearer YOUR_BIANCA_MCP_ACCESS_KEY"
```

If your client cannot store headers, pass the key as `access_key` only as a fallback.

## Get access

If you do not have a Bianca key yet, tell your agent:

```text
Call bianca_access action=request for Bianca beta access. Use my email/contact: <your email>. I have my own Higgsfield account.
```

Bianca returns `request_id` and `claim_token`. Keep both in the same chat. No email key is sent in this flow.

After approval, the agent calls:

```text
bianca_access action=status with the request_id and claim_token
```

That returns the key once. Store it in the MCP connector.

## First run

Paste this after Bianca is connected:

```text
Bianca, what can you do and what should I do first? Use the connected Bianca MCP tools. If access is needed, request it. If setup is ready, create a no-spend brief before any generator spend.
```

Then try the demo prompt: https://fift.studio/bianca/demo-prompt.txt

## Rules for agents

- Use only the public Bianca tools: `bianca`, `bianca_access`, `bianca_status`.
- Call `bianca` for normal content requests.
- Follow Bianca's `next_action` exactly.
- Do not invent prompts, models, schemas, hidden tools, or workflow steps.
- Do not spend generator credits until Bianca returns approved generator jobs.
- Generate only with the user's Higgsfield/generator account.
- Return generated assets to Bianca for attach, QA, package, and delivery.

## Troubleshooting

- If the tool list shows only `bianca`, `bianca_access`, and `bianca_status`, that is correct.
- If you lose the key or claim token, call `bianca_access action=recover` with the account email.
- If generation is blocked, read Bianca's returned `next_action`; it usually needs persona setup, face anchor, factsheet approval, or generator proof.
- If server-side visual QA asks for human review, view the preview URL and provide real visual findings. Do not rubber-stamp.