# MDRN

> MDRN runs your app and gives it hosting, storage, auth, mail and logs, in one account with one bill.
> Source: https://mdrn.io/

Start: Build free, no card. $25 a month when you go live. Sign up at https://console.mdrn.io.

Runs: Next.js, Nuxt, SvelteKit, Astro, React, Vue, Angular, or a plain static site; or your own code in JavaScript, TypeScript, Python, Rust. What deploys unchanged: https://mdrn.io/docs/deploy/frameworks.md.

## Set it up

```sh
npm install -g @mdrnio/cli
mdrn login
mdrn init my-app && cd my-app
mdrn link
mdrn deploy
```

`mdrn deploy` ends with the address the app is live at. The full guide: https://mdrn.io/docs/quickstart.md.

SQLite, Postgres, Objects and Mail are called from the app's backend with the SDK (`npm install @mdrnio/sdk`, `Mdrn.fromEnv(env)`), never from a browser. Auth runs in front of the app and tells the backend who is signed in. Build mode has SQLite only, and its mail goes to the workspace's members only.

## Connect an AI agent (MCP)

Hosted: `https://mcp.mdrn.io/mcp`, signing in with MDRN (Claude Code: `claude mcp add --transport http mdrn https://mcp.mdrn.io/mcp`). The server tells the agent to install and use the CLI to deploy. Details: https://mdrn.io/docs/mcp.md.

A prompt to paste into a coding agent:

```text
Set up MDRN (https://mdrn.io) for this project. MDRN runs the app and gives it hosting, storage (SQLite, Postgres and Objects), auth, mail and logs. Read https://mdrn.io/llms.txt first; every docs page is Markdown at https://mdrn.io/docs/<page>.md.

1. I need an MDRN account. If I don't have one, stop and ask me to sign up at https://console.mdrn.io. Build free, no card. $25 a month when you go live. A new account is in build mode: one project in its Sandbox environment, SQLite only, and an app only the workspace's members can open until I go live.
2. Install the CLI (Node.js 20 or later) and sign in. The browser opens; wait while I approve it.
   npm install -g @mdrnio/cli
   mdrn login
3. Connect MDRN's MCP server, so you can read builds, logs and usage. In Claude Code:
   claude mcp add --transport http mdrn https://mcp.mdrn.io/mcp
   In another client, add a remote MCP server named "mdrn" at https://mcp.mdrn.io/mcp (https://mdrn.io/docs/mcp.md). Its sign-in opens in the browser; wait while I approve it.
4. If this directory has no app yet, start from the template: mdrn init my-app && cd my-app. Then link the directory to a project and deploy:
   mdrn link
   mdrn deploy
   Tell me the address it ends with (Live: https://...). If the build fails, read the lines it prints and https://mdrn.io/docs/errors.md.
5. Call SQLite, Postgres, Objects and Mail only from the app's backend, with the SDK (npm install @mdrnio/sdk; Mdrn.fromEnv(env)). Never from browser code, and never put an MDRN credential in frontend code or in the repository.
6. Ask me before anything that changes what I pay (going live, a custom domain). If a build mode limit or a locked feature stops you, tell me instead of working around it.
```

## Products

- **Deployment**: Push or run one command. We build, test and publish it, and keep your last 10 releases (3 in build mode) to roll back to. `mdrn deploy` or a push to the GitHub branch you connected.
- **SQLite and Postgres**: Two databases side by side, owned by your backend. Restore SQLite to any moment in the last 30 days. Build mode has SQLite only. `mdrn.sqlite.create("notes", …)` from your backend.
- **Objects**: Uploads and downloads through links that expire. No storage keys ever reach a browser. `mdrn.objects.downloadUrl(…)` gives a browser a link that expires.
- **Auth**: Email codes on a sign-in page in your colours, and Google and GitHub with your own keys. Your backend is told who is signed in. `mdrn.auth.user(request)` in your backend says who is signed in.
- **Mail**: Receipts, codes and resets from your own domain, with the delivery result attached. In build mode, mail goes to your workspace’s members only. `mdrn.mail.send({ to, … })` from your backend.
- **Logs**: Follow one request through your whole app and see where it went wrong. `mdrn logs --follow` or the Logs page in the console.
- **Domains**: Your own domain on your app, once you go live. The certificate is taken care of. `mdrn domains add --hostname …` then two DNS records.

## Pricing

$25 a month for the whole account, every project and teammate. Build free, no card. $25 a month when you go live. Included every month: Unlimited projects and teammates; 10 million requests; 600 container minutes; SQLite and Postgres: 0.5 GB stored each; 10 GB of objects; Auth for your app’s users, no per-user price; 3,000 emails; 1 million log lines; 5 custom domains. Usage beyond that is charged after it is used; every rate: https://mdrn.io/pricing/.

## More

- [Docs index for agents](https://mdrn.io/llms.txt)
- [Every docs page in one file](https://mdrn.io/llms-full.txt)
- [Security](https://mdrn.io/security/)
- [Pricing](https://mdrn.io/pricing/)
- [Status](https://mdrn.io/status/)
