Format Finder MCP Server

AI-powered content format discovery and generation, available as tools in Claude Desktop and Claude Code.

Quick Start

npx @format-finder/mcp-server --setup

This will walk you through:

1. Entering your API key
2. Validating it
3. Auto-configuring Claude for you

Get your API key at formatfinder.onepeakcreative.com/settings?section=api

Available Tools

| Tool | Description | Credits | |------|-------------|---------| | list_formats | List all content formats (with optional category filter) | 0 | | get_format | Get details for a specific format by UUID | 0 | | check_credits | Check credit balance and lifetime usage | 0 | | brainstorm | Generate format recommendations for a niche | 5 | | generate_hooks | Generate hooks for a format | 2 | | generate_script | Generate a video script | 10 | | generate_shot_plan | Generate a shot-by-shot filming plan | 5 | | generate_caption | Generate a social media caption | 3 | | check_job | Poll status of an async generation job | 0 |

How Generation Works

Generation tools are asynchronous — they return a jobId that you poll for results:

1. Call a generation tool — returns a jobId
2. Call check_job with the jobId
3. When status is "completed", the result field has your content
4. If status is "failed", the error field explains what went wrong

Example workflow:

list_formats → pick a format
brainstorm(niche) → check_job → get recommendations
generate_hooks(formatId, niche) → check_job → get hooks
generate_script(hookText, formatId, niche) → check_job → get script

Configuration

| Variable | Required | Default | |----------|----------|---------| | FORMAT_FINDER_API_KEY | Yes | — | | FORMAT_FINDER_API_URL | No | https://formatfinder.onepeakcreative.com |

Support

• API Docs: formatfinder.onepeakcreative.com/api/docs
• Get API Key: formatfinder.onepeakcreative.com/settings?section=api