distribute.youdistribute.you
Start

distribute.you Authentication

One key and one header, for the REST API, the MCP server and the CLI alike.

1. Create an account

Sign up at dashboard.distribute.you to get started.

2. Get your API key

After signing in, go to API Keys and create a new key. A key looks like this:

distrib.usr_xxxxxxxxxxxxxxxxxxxxxxxx

Keep this key secret. It acts as you, with full access to every organization you belong to. Issue and revoke keys at https://dashboard.distribute.you/api-keys.

3. Send it

The key is a Bearer token in the Authorization header. It carries your user. Each call acts in one organization: name a brand with brandId, or an organization with orgId. If you belong to a single organization you can name nothing.

Authorization: Bearer distrib.usr_YOUR_KEY

REST API

curl https://api.distribute.you/v1/me \
  -H "Authorization: Bearer distrib.usr_YOUR_KEY"

MCP server

The MCP server is hosted at https://mcp.distribute.you/mcp and takes the same header. From Claude Code:

claude mcp add --transport http distribute https://mcp.distribute.you/mcp --header "Authorization: Bearer distrib.usr_YOUR_KEY"

Command line

The CLI authenticates once with the same key and then reads and changes brands, campaigns, leads, audiences, workflows, runs and billing. It is on npm as @distribute.you/cli.

npx @distribute.you/cli --help

4. Verify

Test the key with one call:

curl https://api.distribute.you/v1/me \
  -H "Authorization: Bearer distrib.usr_YOUR_KEY"

You should see your user and every organization you belong to, with its brands. A 401 means the header is missing, the scheme is not Bearer, or the key is not one of yours: a key always starts with distrib.usr_, and a placeholder such as distrib.usr_YOUR_KEY is not a key.

Security

  • A key is yours, across every organization you belong to. Name a brand (brandId) or an organization (orgId) on each call.
  • Never commit a key to version control
  • Use environment variables for local development
  • Rotate keys periodically from the dashboard
  • You can create several keys and revoke them individually

Every developer surface is named together at https://distribute.you/developers.