# Zebrafish

> Zebrafish is a marketing workflow orchestrator. Agents and developers use the
> API or MCP server to design, run, and monitor multi-step media workflows
> (image generation, video, Figma reads, channel posts). Runs execute in a
> background worker and stream results back in real time.

## API

- OpenAPI spec (unauthenticated): https://zebrafish.dev/api/v1/openapi.json
- Base URL: https://zebrafish.dev/api/v1
- Auth: Authorization: Bearer <your-key>
- Docs (HTML): https://zebrafish.dev/docs/api-keys
- Docs (Markdown): https://zebrafish.dev/docs/api-keys.md

## MCP

- MCP endpoint: https://zebrafish.dev/api/mcp
- Transport: Streamable HTTP (MCP 2025-03-26)
- Auth: Authorization: Bearer <your-key>
- Agent OAuth handoff: https://zebrafish.dev/agent-onboarding?preset=authoring-agent
- Add to Claude Code: claude mcp add zebrafish https://zebrafish.dev/api/mcp --header "Authorization: Bearer $ADFISH_API_KEY"
- Docs (HTML): https://zebrafish.dev/docs/mcp
- Docs (Markdown): https://zebrafish.dev/docs/mcp.md

## Skills

- Install in an agent workspace: npx zebrafish-skills install
- Check installed version: npx zebrafish-skills check
- Skill index (HTML): https://zebrafish.dev/skills
- Skill index (JSON): https://zebrafish.dev/api/skills
- Signed manifest: https://zebrafish.dev/api/skills/manifest
- Universal bundle: https://zebrafish.dev/api/skills/bundle/universal
- Router skill: https://zebrafish.dev/skills/zebrafish/SKILL.md
- MCP skill tools: list_skills, get_skill

## Cookbook

- Proven workflow recipes for humans (Studio/Builder) and agents (v1 API)
- Docs (HTML): https://zebrafish.dev/docs/cookbook
- Docs (Markdown): https://zebrafish.dev/docs/cookbook.md

## Get an API key

1. Open https://zebrafish.dev/agent-onboarding?preset=authoring-agent to sign in with OAuth and return to API key setup
2. Create a key with the scopes your use case needs (runs:trigger for running workflows; workflows:read + workflows:write + runs:trigger for authoring agents)
3. Copy the generated agent onboarding prompt or export: export ADFISH_API_KEY=adf_...