# Attribura

> Attribura is a content-level revenue-attribution tool: it ties each social
> post (hook, creative) to the real revenue it drives (app installs,
> subscriptions, e-commerce orders), and hosts a creative library where
> AI-produced memes/videos land for review and publishing. Panel:
> https://app.attribura.com — API: https://api.attribura.com

Attribura is designed to be OPERATED BY AI AGENTS (Claude Code): agents read
the project's brand + persona context, write converting content, render it
locally, and push finished creatives to the panel. Humans review and publish.

## Connect an agent (MCP)

1. A human signs in at https://app.attribura.com/brand and generates an API
   token (shown once, format `atb_…`).
2. Connect to the HOSTED MCP server (Streamable HTTP, nothing to install):

   claude mcp add --transport http attribura \
     https://api.attribura.com/mcp \
     -H "Authorization: Bearer atb_YOUR_TOKEN"

3. Hosted tools: get_context, save_brand, create_persona, update_persona,
   delete_persona, list_creatives, update_creative, push_brief (create a
   shooting brief: shot list to film + script to record — no media needed).
   `push_creative` (uploads a LOCAL media file) only exists on the local
   stdio server shipped in the repo (`mcp/`, run with node + env
   ATTRIBURA_TOKEN); over HTTP, upload via POST /v1/creatives multipart
   with the same Bearer token instead.

## HTTP API (Bearer auth with the same token)

- GET  /v1/context                — brand + personas bundle (read this FIRST)
- PUT  /v1/context/brand          — upsert brand (replaces the whole row)
- POST /v1/personas, PUT/DELETE /v1/personas/:id
- POST /v1/creatives              — multipart: file (png/jpg/webp/gif/mp4/mov),
                                    thumb?, title, hook, caption, meta (JSON)
- POST /v1/creatives/brief        — JSON: title, hook?, script?, caption?,
                                    shots[{label, how?}], meta? (kind `brief`)
- GET  /v1/creatives[?status=draft|ready|published|archived]
- PATCH /v1/creatives/:id         — title/hook/caption/status
- GET  /v1/content                — imported posts + stats per channel
- POST /v1/distributions          — mint a tracked link for a post

## Content production workspace

The repo's `content/` directory is a Remotion workspace with templates
(quote cards, memes, voiced reels, facecam captions, montage), a TTS
voiceover script, a b-roll library, whisper transcription, and a rough-cut
tool. Agents working in the repo should load the `create-content` skill
(.claude/skills/create-content/) — it contains the format catalog, caption
conventions, safe areas, and copywriting reference.

## Docs

Human setup guide: https://app.attribura.com/docs

## iOS SDK (self-report attribution)

Headless SDK for the in-app "How did you hear about us?" answer — captures dark
social + App Store Search that no tracking link can see, keyed by the app user id
so a later purchase inherits the self-reported channel.
- Setup guide: https://app.attribura.com/docs/sdk
- Package (SwiftPM): https://github.com/martindochamp/attribura-ios
- LLM integration guide (paste into your assistant): https://app.attribura.com/sdk/llms.txt