# Vibiz Stack

> One API for what a new business needs online: hosting, a Postgres database, sign-in, email, AI, payments (Vibiz is the merchant) and US company formation, with usage, limits and keys in one place. Built for builders and their AI agents.

## Start here (agents)

0. Setting up for the first time? Follow https://app.vibiz.app/get-started.md: the CLI, the skills and the MCP connection, once per machine.
1. Log in: run `npx @vibiz/cli login`. It prints a link and a code: show the link to the person and ask them to open it and click Authorize (a Vibiz Stack account is opened for them if they have none). Running it again keeps waiting on the same code. Never ask for a key in the chat.
2. Or connect the remote MCP server, nothing to install: `claude mcp add --transport http vibiz https://app.vibiz.app/mcp` (Cursor and Codex: the same URL). The client opens the same sign-in on first use.
3. Build: `npx @vibiz/cli init "<name>"` in the app folder (`--template nextjs-saas` for a starter app), `npx @vibiz/cli dev` for the development env, `npx @vibiz/cli deploy` to go live at <slug>.vibiz.app.
4. You hold an agent key: everything in development, deploys, AI. Live money, real filings and production secrets are the person's: errors carry `details.next_step` to pass on.

Every page is also plain markdown: add `.md` to its URL. Everything in one file: https://app.vibiz.app/llms-full.txt. API base URL: https://app.vibiz.app/v1.

## Getting started

- [What is Vibiz Stack](https://app.vibiz.app/docs/introduction.md): One API and one key for what a new business needs online, built for builders and their AI agents.
- [Quickstart](https://app.vibiz.app/docs/quickstart.md): Start from your agent with one prompt, or open an account, log in the CLI, create a project and deploy it yourself.
- [Use one service](https://app.vibiz.app/docs/use-one.md): Use just one Vibiz service - sign-in, a database, payments, email, AI, analytics, files, web data - from an app hosted anywhere, a plain site, a mobile app's backend or a script.
- [Keys and environments](https://app.vibiz.app/docs/keys.md): Owner, agent and app keys; production and development; who may do what.
- [Billing and credits](https://app.vibiz.app/docs/billing.md): Prepaid credits per account, how usage draws them down, adding credits by card, auto-recharge, and what happens at zero.

## Products

- [Hosting](https://app.vibiz.app/docs/hosting.md): Deploy a folder to <slug>.vibiz.app. Production by default, previews on request, instant promote and rollback.
- [Domains](https://app.vibiz.app/docs/domains.md): Every app gets <slug>.vibiz.app. Buy a domain of its own from your credits, registered to you and live on the app at once.
- [Database](https://app.vibiz.app/docs/database.md): A Postgres database per project, plus an empty development branch agents can use without touching production data.
- [Sign-in](https://app.vibiz.app/docs/sign-in.md): Email and password, verification, magic links and social sign-in per project and environment, with allowed email domains.
- [Email](https://app.vibiz.app/docs/email.md): Send from <mailbox>@<slug>.vibiz.app; a real inbox at your own domain (hello@yourcompany.com), read here and replied to as itself, or forwarded; and email your users - contacts, newsletters, announcements and automations - with one-click unsubscribe and deliverability built in.
- [AI](https://app.vibiz.app/docs/ai.md): An OpenAI-compatible gateway to every major lab's models, for chat, embeddings, images, video, speech and transcription, metered per call.
- [Files](https://app.vibiz.app/docs/files.md): A drive per project. Every image, video and audio the AI generates is saved there by itself with a permanent link, next to the files your app and agents upload.
- [Payments](https://app.vibiz.app/docs/payments.md): Take one-time payments and subscriptions from the first call. Vibiz is the merchant; the owner verifies their identity only to withdraw.
- [Social](https://app.vibiz.app/docs/social.md): Connect the business's own social and ad accounts, publish and schedule posts with media, read analytics, and run ad campaigns, with the owner approving what goes out.
- [Company formation](https://app.vibiz.app/docs/company.md): Form a US LLC or C-Corp in any state, with the registered agent, the EIN and the formation documents. Agents draft; the owner files.
- [Analytics and replay](https://app.vibiz.app/docs/analytics.md): Cookieless web analytics on by default, server-side events, and opt-in session replay with masking.
- [Web data: scrape, search, ads library](https://app.vibiz.app/docs/actions.md): Scrape or crawl a site, search the web, screenshot a page, pull competitor ads from the Meta Ad Library, Google Maps places and reviews, Instagram and TikTok, product prices and LinkedIn companies - one call each, billed per call, every run kept.
- [Design: learn a site's design system](https://app.vibiz.app/docs/design.md): web.design reads a website's design - colors, type scale, radii, spacing, component styles, section layout and screenshots - and hands back a Tailwind v4 theme, a shadcn/ui theme, CSS variables and a brief your agent follows, so the apps it builds look good from the first screen.
- [Usage and limits](https://app.vibiz.app/docs/usage.md): What the account used and what it cost, per tool, model, project, key or end user, and how close it is to today's limits.
- [Connectors](https://app.vibiz.app/docs/connectors.md): Add any HTTP API to a project from one manifest or an OpenAPI spec; Vibiz keeps its key sealed, puts it in the app's env and proxies calls with approvals.
- [Export](https://app.vibiz.app/docs/export.md): Take your app anywhere, or keep a backup: its code, its database as SQL, and a guide to the variables it runs with.

## Agents

- [Agents](https://app.vibiz.app/docs/agents.md): Give Claude Code, Codex or Cursor the Vibiz tools over MCP, use the CLI, read the docs tool, and install the agent skills.
- [CLI](https://app.vibiz.app/docs/cli.md): Every vibiz command, exactly as `vibiz --help` prints it, with the environment variables it reads.
- [Agent skills](https://app.vibiz.app/docs/skills.md): Installable SKILL.md bundles that teach Claude Code, Codex and Cursor how to use Vibiz Stack, one per product.
- [Console links](https://app.vibiz.app/docs/console-urls.md): Every console page takes its view in the URL, and API results carry console_url, so agents send people straight to the right page.

## Reference

- [API reference](https://app.vibiz.app/docs/api.md): Every route of the Vibiz Stack HTTP API, generated from the routes the API registers.
- [Errors](https://app.vibiz.app/docs/errors.md): Every error code, its HTTP status, what it means and what to do next.
- [@vibiz/app](https://app.vibiz.app/docs/app-sdk.md): The client a running app uses, on one key - env, AI, email, actions, events, payments and webhooks.

## Agent guides

- [Payments: how money moves](https://app.vibiz.app/docs/guides/payments.md): Fees, the 7-day hold, who may refund or withdraw, and the agent flow for selling a plan.
- [Payments in the app (@vibiz/app)](https://app.vibiz.app/docs/guides/app-payments.md): Checkout, subscription checks and the customer portal from the app's server, with @vibiz/app or plain HTTP.
- [Webhooks: Vibiz tells the app when someone pays](https://app.vibiz.app/docs/guides/webhooks.md): Set the webhook URL, verify the Vibiz-Signature on the raw body, dedupe on event id, and test it.
- [Company formation: cost and what is needed](https://app.vibiz.app/docs/guides/company.md): What a US LLC or C-Corp costs through Vibiz (in cents), what a draft needs, and who may file.
- [Keys and environments](https://app.vibiz.app/docs/guides/keys.md): Agent, owner and app keys, what each may do, the development environment, and where the project id is.
- [Usage, cost and limits](https://app.vibiz.app/docs/guides/usage.md): What was spent, today's ceilings and when they reset, and how to read the usage breakdown.
- [Custom connectors: the user’s own APIs through Vibiz](https://app.vibiz.app/docs/guides/connectors.md): Add any HTTP API from an OpenAPI spec or a short manifest, set its key per environment, and call it through Vibiz with approvals for risky operations.
- [Social: posting, approvals and ads](https://app.vibiz.app/docs/guides/social.md): How an agent posts and schedules to the business's own accounts, what the owner approves, per-platform options, and ad changes in cents.
- [Console links](https://app.vibiz.app/docs/guides/console-urls.md): Every web console page and the query parameters it takes, so an agent can hand a person a link that opens exactly the right view.

## Agent skills

- [vibiz](https://app.vibiz.app/skills/vibiz/SKILL.md): Start here for Vibiz Stack - what it can do (hosting, Postgres, sign-in, email and a business inbox, newsletters, AI models, files, payments, analytics with session replay, web data and design, social, connectors, company formation, domains), which skill covers each, how to log in or connect the MCP server, the one-key model (VIBIZ_APP_KEY), credits and spend limits, and the rules every Vibiz task follows (console links, owner-only steps). Use when starting with Vibiz Stack, when someone asks what Vibiz can do or which service fits, or when no other vibiz-* skill matches.
- [vibiz-ai](https://app.vibiz.app/skills/vibiz-ai/SKILL.md): Use AI models through Vibiz Stack - chat with GPT, Claude, Gemini, Kimi, DeepSeek and every major lab's models by id, generate images (Nano Banana, GPT Image), text to speech and transcription, from an agent (MCP tools, CLI) or from an app with one key (OpenAI-compatible, new OpenAI(vibiz.ai)) - with per-call prices, the daily spend ceiling, project budgets and the account's own Google key. Use when an app needs an LLM, images or voice, when you need to generate an image or audio for a project, or someone asks what a model costs or which models they can call.
- [vibiz-analytics](https://app.vibiz.app/skills/vibiz-analytics/SKILL.md): Set up and read a Vibiz Stack project's visitor analytics (cookieless pageviews, sources, countries, devices, custom and server-side events) together with session replay (masked recordings of what went wrong for visitors - JS errors, rage and dead clicks, abandoned forms - with insights and private links to watch a session), on Vibiz hosting or any other site. Use when someone wants analytics, to track visits or events, asks how their site is doing, where visitors come from, or what is going wrong for users - and always set up replays along with analytics.
- [vibiz-auth](https://app.vibiz.app/skills/vibiz-auth/SKILL.md): Set up and change sign-in for a Vibiz Stack project - email and password, verification, magic links, Google, GitHub or Vercel sign-in, allowed email domains, and the callback URLs to register. Use when a Vibiz project's users need to sign in or its sign-in settings need changing.
- [vibiz-broadcasts](https://app.vibiz.app/skills/vibiz-broadcasts/SKILL.md): Email a Vibiz Stack project's users and subscribers - contacts from the app at signup, safe CSV imports, newsletters and announcements (broadcasts) with a review step, and automations such as onboarding sequences and trial reminders - with one-click unsubscribe, sending pace and spam protection built in. Use when a business wants to email its users about its software, send a newsletter or product update, or set up an onboarding or re-engagement sequence.
- [vibiz-company](https://app.vibiz.app/skills/vibiz-company/SKILL.md): Form the US company behind a Vibiz Stack project (LLC or C-Corp, any state) - read the fee catalog in cents, quote the total, draft the filing and fix its problems, and hand the real submission to the owner. Use when someone asks what forming an LLC or corporation costs through Vibiz, or wants to incorporate the business behind their app.
- [vibiz-connectors](https://app.vibiz.app/skills/vibiz-connectors/SKILL.md): Connect a Vibiz Stack project to any outside HTTP API (a CRM, a weather or shipping API, an internal service) as a custom connector - import its OpenAPI spec or write a short manifest, set its key per environment, and call it through Vibiz with approvals for risky operations. Use when a Vibiz app or agent needs a third-party API that Vibiz doesn't provide itself.
- [vibiz-database](https://app.vibiz.app/skills/vibiz-database/SKILL.md): Work with a Vibiz Stack project's Postgres database - get the development DATABASE_URL, run migrations, inspect tables and run read-only queries, without ever touching production rows. Use when a Vibiz project needs schema changes, queries, seed data or a look at its data.
- [vibiz-deploy](https://app.vibiz.app/skills/vibiz-deploy/SKILL.md): Create a Vibiz Stack project and deploy it - vibiz init, the development env for local work, deploy to <slug>.vibiz.app, previews, promote and instant rollback, run the app on another host with one key, or export it (code, database, env guide) to take it elsewhere. Use when an app should go live on Vibiz or a Vibiz project needs a new deployment or a rollback.
- [vibiz-design](https://app.vibiz.app/skills/vibiz-design/SKILL.md): Make the UI you build look good from the first screen - learn a website's design system with Vibiz Stack (web.design - colors, type scale, radii, spacing, component styles, section layout, screenshots) and apply its Tailwind v4, shadcn/ui or CSS theme and brief; or, with no reference, follow a short default design checklist. Use when building or redesigning a page, an app's UI, a landing page or a dashboard, when the person names a site they like ("make it look like Linear"), or when they have an existing site or brand the new app should match.
- [vibiz-email](https://app.vibiz.app/skills/vibiz-email/SKILL.md): Send email from a Vibiz Stack project's own address (<mailbox>@<slug>.vibiz.app) - add the email resource, send from the app with @vibiz/app or HTTP, and stay within 50 emails per project per day - run the business's own inbox (hello@theirdomain.com kept in Vibiz; read, reply and send as it, with received mail treated as untrusted) - or forward that address to the owner's own inbox. Use when a Vibiz project needs to send welcome, receipt or notification emails, or the business wants email at its own domain, or asks to check or answer its mail.
- [vibiz-files](https://app.vibiz.app/skills/vibiz-files/SKILL.md): Store and find files in a Vibiz Stack project's Files (a drive per project with permanent links) - find an image, video or audio you or the app generated earlier, upload a logo or product photo and get its link, import a file from a URL, private files with signed links, and file uploads from the app with one key. Use when you need a file's permanent URL, want to reuse something generated before, or an app needs to store user uploads, avatars or downloads.
- [vibiz-payments](https://app.vibiz.app/skills/vibiz-payments/SKILL.md): Sell with Vibiz Stack payments - take money with no identity check and no Stripe account (Vibiz is the merchant; KYC only when the owner withdraws) or through the owner's own Stripe account, create a plan, add a checkout or Upgrade button, wire and verify payment webhooks, check subscriptions, and answer questions about fees (2% Vibiz fee plus card processing), the 7-day hold, refunds and withdrawing. Use when a Vibiz project (a vibiz.json in the folder, or the vibiz MCP tools) needs to take money or someone asks what a payment leaves them.
- [vibiz-social](https://app.vibiz.app/skills/vibiz-social/SKILL.md): Post and schedule to a Vibiz Stack project's own social accounts (Instagram, TikTok, LinkedIn, X, YouTube, Pinterest, Threads, Facebook, Bluesky…), read post analytics, and pause, resume, re-budget or boost ad campaigns, with the owner approving anything live. Use when someone wants to publish, schedule, connect a social or ad account, or check how posts and campaigns perform for the business behind their app.
- [vibiz-use-one](https://app.vibiz.app/skills/vibiz-use-one/SKILL.md): Use just one Vibiz Stack service (sign-in, database, payments, email, AI, analytics, replay, files, web data, connectors, social, company) from an app NOT hosted on Vibiz - another host, a plain HTML site, a mobile app's backend, a cron job or a script - creating a project with only that resource, adding the app's domain as running elsewhere, and giving the app its one key. Use when someone wants one Vibiz feature without deploying on Vibiz, or the app already runs somewhere else.
- [vibiz-web-data](https://app.vibiz.app/skills/vibiz-web-data/SKILL.md): Get data from the web with Vibiz Stack - scrape a page or crawl a whole site to markdown, search the web or the news, screenshot a page, pull competitor ads from the Facebook / Meta Ad Library, find businesses on Google Maps, read Google or Trustpilot reviews, Instagram and TikTok profiles and hashtag posts, product prices from any shop, and public LinkedIn company pages. Use when someone wants to scrape, crawl, search the web, research competitors or their ads, find leads or places, collect reviews, check product prices, or look at an Instagram/TikTok profile, and the vibiz CLI or MCP tools are available.