# Figgshield overview

> What Figgshield is — an MCP server and CLI tool for generating video with Kling and images with Nano Banana 2 inside Claude — plus a five-minute quickstart to add it and generate.

Figgshield is an **MCP server and CLI tool**. You add it to **Claude** (as a connector) or the **Claude Code CLI**, then generate **video with Kling** and **images with Nano Banana 2** by asking in plain language. Figgshield runs the job, meters the credits, and hands back a file. The web app is only for account management — signing in, choosing a plan, and managing API keys.

There are two models and one credit balance:

| Model | Kind | Credits | Options |
| --- | --- | --- | --- |
| **Kling** | video | 35 (5s) · 70 (5s + audio or 10s) | durations 5/10s, 720p/1080p, optional audio |
| **Nano Banana 2** | image | 8 | 1K / 2K / 4K |

## Ways to use it

| Surface | How | Auth |
| --- | --- | --- |
| **Claude** (Desktop / web) | Add Figgshield as a connector under Settings → Connectors | Browser sign-in (OAuth) |
| **Claude Code CLI** | `claude mcp add --transport http figgshield https://api.figgshield.ai/mcp` | `claude mcp login` (OAuth) or an API key header |
| **REST API** (non-MCP) | `POST https://api.figgshield.ai/api/generations/create/` | `Authorization: Bearer figg_...` API key |

Everything shares one account, one plan and one credit balance.

Every page of this documentation has a Markdown twin at the same URL with `.md` appended (this page: [`/documentation/index.md`](https://figgshield.ai/documentation/index.md)). There is also an [llms.txt](https://figgshield.ai/llms.txt) index, the [complete docs in one file](https://figgshield.ai/llms-full.txt), and a machine-readable [OpenAPI 3.1 specification](https://figgshield.ai/openapi.json).

## Five-minute quickstart: add to Claude and generate

You need a Figgshield account with an active subscription — any plan works. Sign in at the app with Google, Apple or GitHub and pick a plan; then connect Claude.

### 1. Add the connector

In **Claude Desktop or claude.ai**, open **Settings → Connectors → Add custom connector** and paste the MCP endpoint:

```text
https://api.figgshield.ai/mcp
```

Claude opens a browser sign-in. Approve the two scopes (`figgshield:read`, `figgshield:write`) and the connector is ready. See [MCP server & tools](https://figgshield.ai/documentation/mcp.md) for the full walkthrough, the config JSON and every tool.

### 2. Ask for a generation

Prompt Claude in plain language:

```text
Generate a 5-second video of a quiet harbour at dawn, mist lifting off the water.
```

Claude calls Figgshield's `generate_video` tool, which runs Kling, spends 35 credits, and returns a generation id plus an `output_url` once the clip is ready. For an image, just ask for one — Claude calls `generate_image`, which runs Nano Banana 2 for 8 credits.

### 3. Get the file

Video jobs take tens of seconds; Claude polls `get_generation` for you and hands back the download link. Images usually return in one step. Ask Claude to _"show my recent generations"_ and it calls `list_library`; ask _"how many credits do I have left"_ and it calls `get_usage`.

That is the whole loop: connect once, then ask. No keys to paste, nothing to poll by hand.

### Prefer the CLI or a script?

- [Claude Code CLI](https://figgshield.ai/documentation/cli.md) — `claude mcp add` then `claude mcp login`, or a personal API key header.
- [Generations (REST)](https://figgshield.ai/documentation/generations.md) — the non-MCP path: create a key, `POST` a job, poll it, download the output.

## Where to go next

- [MCP server & tools](https://figgshield.ai/documentation/mcp.md) — add the connector, the five tools, example prompts, config JSON.
- [Claude Code CLI](https://figgshield.ai/documentation/cli.md) — loopback sign-in and the API-key alternative.
- [Authentication](https://figgshield.ai/documentation/authentication.md) — SSO sign-in, OAuth for the connector, personal API keys.
- [Models](https://figgshield.ai/documentation/models.md) — Kling and Nano Banana 2, parameters and credit costs.
- [Generations (REST)](https://figgshield.ai/documentation/generations.md) — the full REST job lifecycle for non-MCP clients.
- [Usage & credits](https://figgshield.ai/documentation/usage.md) — usage summary and the credit ledger.
- [Billing & top-ups](https://figgshield.ai/documentation/billing.md) — the four plans, annual billing, and top-ups.
- [Errors](https://figgshield.ai/documentation/errors.md) — every machine code, its HTTP status, and what to do about it.