# Figgshield

> Figgshield is an MCP server and CLI tool for generating AI video and images. Add it to
> Claude (as a connector) or the Claude Code CLI and generate video with Kling and images
> with Nano Banana 2 by prompting; credits are metered and billed via an annual
> subscription. A REST API at https://api.figgshield.ai is the non-MCP option,
> authenticated with `Authorization: Bearer figg_...` API keys. Every page of the human
> documentation has a Markdown twin at the same URL with `.md` appended.

Figgshield is an MCP server and CLI tool: add it to Claude (as a connector) or the Claude Code CLI and generate video with Kling and images with Nano Banana 2 by prompting. The MCP endpoint is `https://api.figgshield.ai/mcp` (Streamable HTTP); authenticate with OAuth 2.1 (browser sign-in, PKCE) or an API key (`Authorization: Bearer figg_...`). The five tools are generate_image, generate_video, get_generation, list_library and get_usage. Two models share one credit balance: a Nano Banana 2 image is 8 credits; a 5-second Kling clip is 35 credits (70 for 10 seconds or with audio). Failed generations are refunded automatically. A non-MCP REST API is also available at https://api.figgshield.ai: `POST /api/generations/create/` returns a job; poll `GET /api/generations/{uuid}/` no more often than every 2 seconds until `status` is `succeeded` or `failed`, then download `output_url`. Lists use the envelope `{"pagination": {...}, "data": [...]}`; errors use `{"error": "<machine_code>", "detail": "<sentence>"}`. Four plans, billed annually (displayed monthly): Lite $6/month ($72/year), Starter $12 ($144/year), Pro $29 ($348/year), Studio $75 ($900/year); credit top-ups start at $50.

## Getting started

- [Figgshield overview](https://figgshield.ai/documentation/index.md): 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.
- [MCP server & tools](https://figgshield.ai/documentation/mcp.md): Add Figgshield as an MCP connector in Claude or the Claude Code CLI, the five tools (generate_image, generate_video, get_generation, list_library, get_usage), example prompts, config JSON and OAuth discovery.
- [Claude Code CLI](https://figgshield.ai/documentation/cli.md): Use Figgshield from the Claude Code CLI: claude mcp add plus claude mcp login (loopback PKCE), or the personal API-key header alternative, then generate by prompting.
- [Authentication](https://figgshield.ai/documentation/authentication.md): How Figgshield authenticates: SSO sign-in (Google, Apple, GitHub), OAuth 2.1 for the MCP connector and CLI, and personal API keys (Authorization: Bearer figg_...) for the CLI and REST.

## API reference

- [Models](https://figgshield.ai/documentation/models.md): The two live models — Kling for video and Nano Banana 2 for images — with their parameters, live status semantics and per-generation credit costs.
- [Generations (REST)](https://figgshield.ai/documentation/generations.md): The non-MCP path: create Kling video and Nano Banana 2 image jobs over REST, poll them to completion, list and delete them, and how credits are charged and refunded.
- [Usage & credits](https://figgshield.ai/documentation/usage.md): The usage summary endpoint — plan, balance, in-flight jobs, 30-day history — and the credit ledger with its entry types. Also backs the get_usage MCP tool.
- [Billing & top-ups](https://figgshield.ai/documentation/billing.md): The three plans (Starter, Pro, Studio), annual-only billing, checkout and portal, manual top-ups from $50, automatic top-ups, and the credit conversion formula.
- [Errors](https://figgshield.ai/documentation/errors.md): The error envelope and every machine code with its HTTP status, what it means, and what your client should do about it.
- [Admin metrics](https://figgshield.ai/documentation/admin.md): Staff-only platform metrics: GET /api/admin/metrics/, its full response shape, and the 403 admin_required returned to non-staff accounts.

## Optional

- [Pricing](https://figgshield.ai/pricing/): Plans (Lite/Starter/Pro/Studio, billed annually) and the per-generation credit cost table.
- [Complete documentation in one file](https://figgshield.ai/llms-full.txt): Every docs page concatenated into a single Markdown file.
- [OpenAPI 3.1 specification](https://figgshield.ai/openapi.json): Machine-readable schema for every endpoint, with examples and error codes.