Works with Claude Code and Codex over MCP

Stop shipping apps nobody sees.

DistributionOS gives Codex and Claude Code the product context, research, briefs, and tracking they need to market the app you just built. You keep building. Your agent does the distribution work from real context, and remembers what shipped.

$50/app/month or $500/app/year · every feature · unlimited app records

170+

MCP tools your agent can call

2

Tested clients: Claude Code and Codex

1

Connection per account, any app you own

0

API keys stored in your repo

How it works

From a blank prompt to a tracked, live page.

Four stations. Your agent moves through them on every marketing task, and each pass leaves the Brain Doc smarter than before.

01 · Connect

Connect your agent in one sitting.

DistributionOS is a remote MCP server. Add it once to Claude or Codex, approve your app in the browser, and every future session can call it. No API keys in your repo.

  • Claude connector or direct remote MCP for Claude Code
  • codex mcp add, then codex mcp login, for Codex
  • OAuth with PKCE, scoped read and write access per app
Claude · Settings · Connectors

Claude Code

Connector or direct remote MCP

Codex

codex mcp add + login

02 · Context

Build the Brain Doc your agent reads first.

Your agent inspects the repo and submits grounded context. You review it once. From then on every marketing task starts from the product, audience, positioning, proof, and guardrails instead of a blank prompt.

  • Layer 1: foundational product and audience context
  • Layer 2: performance intelligence that updates as work ships
  • Versioned, so you can see what changed and why
distributionos · brain doc · toast-photos

Layer 1 · Foundation

  • Product96%

    What Toast Photos does and for whom

  • Audience88%

    Couples, planners, and photographers

  • Positioning82%

    The hashtag alternative that collects real photos

  • Proof64%

    Live pages, reviews, and usage evidence

  • Guardrails74%

    Claims to avoid, voice, and tracking rules

Layer 2 · Performance intelligenceLearns from shipped work

03 · Brief

Ask for marketing work and get a real brief.

Pages, blog posts, social posts, launch plans, emails, and image direction come back as reviewable briefs with the search angle, proof, and tracking requirements attached. Your agent then builds in your own repo or CMS.

  • Keyword and SERP research built into the handoff
  • Image direction using real screenshots and existing assets
  • Marketing pipeline keeps initiatives, packages, and tasks in order
marketing pipeline · brief · wedding-hashtag-replacement
get_brain_docresearch_keywordsprepare_content_assignment
Audience
Couples and wedding planners
Angle
Hashtags no longer collect the real photos
Search intent
wedding hashtag alternative
Page CTA
Create a Toast event
Image direction
QR code on a reception table
Tracking
Tag CTA clicks, report the live URL
Your agent writes and publishes in your own repo or CMS.review required

04 · Ship and learn

Report what shipped. See what it earned.

Your agent reports the live URL. DistributionOS tracks visitors, high-intent actions, and attribution for that page, then feeds the result back into the Brain Doc so the next brief is sharper.

  • Shipped URLs tracked with first-party analytics
  • Attribution that follows clicks, not just impressions
  • Weekly Brain Doc improvements from real outcomes
distributionos · analytics · toast-photos
  • toastphotos.app/wedding-hashtag-alternativeLanding pageTracked
  • toastphotos.app/blog/why-wedding-hashtags-stopped-workingBlog postTracked
High-intent actions+32 attributed
Human visitors214
Sessions286
Pageviews341

Results flow back into the Brain Doc so the next brief starts from what actually worked.

What your agent gets

Everything a marketing-capable agent needs, in one connection.

Not a content generator. A memory, research, handoff, and measurement layer your agent calls while it works in your repo.

Layer 1

  • Product
  • Audience
  • Positioning
  • Proof
  • Guardrails

Layer 2

  • Best converting anglehashtag alt
  • Top channelorganic search
  • Last learning2h ago
  • Versionv14

Brain Doc

Available

Product, personas, positioning, proof, and guardrails in one versioned document. Layer 2 learns from analytics every week.

  • wedding hashtag alternativehigh
  • wedding photo sharing apphigh
  • qr code wedding photosmedium
  • collect guest photosmedium

Search research

Available

Keyword banks, SERP analysis, and search intent ranked for your audience, attached to every brief.

InitiativeLaunch the wedding hashtag angle
PackageLanding page + blog + 3 social posts
TaskWrite wedding-hashtag-alternative page

Marketing pipeline

Available

Initiatives hold work packages. Packages hold claimable tasks. Your agent always knows what to do next.

Capture

Available

Capture real screenshots and screen recordings to show how your product works. No AI image generation.

Shipped URL tracking

Available

First-party analytics on every page your agent reports. Human visitors, high-intent actions, and attribution, not vanity counts.

  • “best wedding photo sharing app”cited
  • “wedding hashtag alternative”cited
  • “how to collect guest photos”gap

AI visibility

Available

Check whether supported AI assistants mention your app for the buyer questions that matter, and get remediation packets when they do not.

Strategy Canvas example mapping app context, channels, activation, and evidence

Strategy Canvas

Available

Map the distribution system, funnel, campaign, or experiment loop on one canvas that you and your agent can both read and revise.

See examples

MCP-first

One connection. 170+ tools your agent already knows how to call.

DistributionOS speaks Model Context Protocol over Streamable HTTP with OAuth. Your agent discovers the tools itself. You approve the app once in the browser.

Add DistributionOS as a Claude connector once. It is then available in Claude Code sessions signed in with the same Claude account.

# Claude → Settings → Connectors → Add custom connector
Name: DistributionOS
URL:  https://distributionos.dev/api/mcp
# Leave the OAuth client fields blank. Approve in the browser and pick your app.

Need the full reference? Read the API and MCP docs.

get_app_contextget_brain_docupdate_brain_docresearch_keywordsanalyze_serpprepare_content_assignmentvalidate_content_draftreport_implementationcreate_tracked_linkget_analytics_summaryget_artifactget_marketing_pipelineget_next_marketing_taskpropose_marketing_work
run_ai_visibility_readinessget_ai_visibility_summaryget_strategy_canvaspropose_strategy_canvas_patchrecord_product_changesearch_brain_vaultlist_memory_learningsget_trusted_revenue_summaryupsert_measurement_goalverify_analytics_installcreate_social_postlist_social_channelscreate_outreach_campaigngenerate_outcome_report

Proof

Real prompt. Real pages. Real numbers.

This is Toast Photos, one of our own apps. One plain request to the agent, a DistributionOS brief, two live pages, and tracked results.

The prompt
Agent prompt asking DistributionOS to write a marketing page for my app

The brief DistributionOS returned

Toast Photos: wedding hashtag replacement

  • Audience: couples and wedding planners
  • Angle: wedding hashtags no longer collect the real photos
  • Page CTA: create a Toast event
  • Image direction: QR code on a reception table
  • Tracking: tag CTA clicks and report the live URL
Live landing pageopen ->
Wedding hashtag alternative screenshot

Wedding hashtag alternative

Live blog postopen ->
Why wedding hashtags stopped working screenshot

Why wedding hashtags stopped working

Tracked results

7D
Human visitors
0
Sessions
0
Pageviews
0
High-intent actions
0

Counted by DistributionOS first-party analytics on the reported URLs. Bots filtered.

A note from the builder

hey, it's Law

I built this because I suck at distributing.

I've been building apps with AI for the last two years. Building apps has gotten easier as AI agents have gotten smarter, but distribution is still very hard.

I keep thinking: AI agents are already way smarter than me at a lot of this, so why not use their brains to help me market my apps too?

That's why I'm wrapping my agents around DistributionOS. I want the app context, research, pages, social posts, videos, and follow-up work to live in one place instead of scattered across a bunch of disconnected tools.

The goal is for DistributionOS to become the operating system for distributing an app: one place to help your agent understand what you're building, what to market, what shipped, and what worked.

I'm building this for myself, and for other indie hackers who want to spend less time forcing themselves to do marketing and more time building the apps they actually want to make.

Connect your agent

Pricing

One plan. Every feature. Per app.

Subscribe each app for $50 monthly or $500 yearly. Choose the billing cadence, not which features you get.

Full access

$50/app/month

Pay month to month. Cancel any time.

Connect your agent

Unlimited app records. Each subscribed app is billed separately with its own allowances.

Every subscribed app includes

  • Every feature and marketing tool
  • Unlimited marketing tasks and agent handoffs
  • Capture screenshots and screen recordings
  • 5 connected social profiles
  • 50 fresh research runs each month
  • 250 AI visibility checks each month
  • A shared app profile your agent can reuse instead of starting from a blank chat

Monthly and yearly billing unlock the same available features. AI image generation and media credit top-ups are no longer offered.

Honest status

What works now, and what is still in development.

We only market what you can use today. Everything else is labeled.

Available now

  • Reusable app context (Brain Doc) your agent reads first
  • Marketing tasks for pages, blogs, social, email, and launches
  • Keyword and SERP research inside the brief handoff
  • Real screenshots and screen recordings with Capture
  • Shipped URL tracking, analytics, and attribution
  • AI visibility checks and readiness audits
  • Strategy Canvas your agent can read and revise

In development

  • Scheduled marketing work
  • Social posting tools
  • Instagram, TikTok, and competitor tracking
  • Weekly recommendations for what to try next

FAQ

Plain answers before you connect your agent.

What is DistributionOS?

DistributionOS is distribution memory and marketing context for Codex and Claude Code. It keeps an app’s product, audience, proof, research, reviewable briefs, tracking requirements, and shipped work together so the supported agent can work from specific context instead of another blank prompt.

Do I need to understand MCP or APIs?

No. The setup gives your AI agent what it needs. The technical details are there in the docs if you want them.

What does DistributionOS give my agent?

It gives your agent the app details, customer angle, research, image notes, and tracking checklist it needs to help market the app.

What can my agent make with it?

Pages, blog posts, social posts, launch ideas, emails, image prompts, and simple tracking plans.

Does it publish everything for me?

No. Your agent still uses your existing app, repo, or CMS. DistributionOS helps it know what to make and remember what went live.

How does pricing work?

You pay per subscribed app: $50 monthly or $500 yearly. Both options include every available feature. Each app gets its own social profile, research, and AI visibility allowances. AI image generation and media credit top-ups are no longer offered.

What is an AI visibility check?

One check tests one monitored buyer question with one supported AI provider. Official Google Search Console imports, crawler activity, readiness checks, and observations you record manually do not use these checks.

Can I use images or videos made somewhere else?

Yes. Use your own images and videos, including real screenshots from Capture. DistributionOS no longer generates AI images or sells media credit top-ups. Existing stored images remain available.

Why not just ask my agent directly?

You can. DistributionOS helps when you do not want to explain the app, customer, angle, and past work from scratch every time.

Give your agent the context to market what you build.

Create the app, choose monthly or yearly billing, then run the setup review from your app folder. Most builders are connected in one sitting.