Getting Started
Get a Postgres database running in under a minute.
1. Sign up
Create an account at basely.cc.
2. Get your API key
Copy your API key from the dashboard. Keep it secret — treat it like a password.
3. Install the CLI
npm install -g @basely-cli/cli4. Connect
basely auth setup --url https://api.basely.cc --key <your-key>5. Create a project
basely projects create myapp
→ Returns a Postgres connection string. Save it — shown once.6. Run a migration
basely migration push myapp --name 001_init --file ./schema.sqlCLI Reference
All available commands.
Auth
basely auth setup --url <url> --key <key>Projects
basely projects create [id]
basely projects list
basely projects delete <id>Database
basely db execute <project> --sql "SELECT 1"
basely db schema <project>Migrations
basely migration push <project> --name <name> --file <file>
basely migration list <project>Type Generation
basely gen types <project> --out src/db.tsMCP / AI Agents
basely ships an MCP server so AI tools like Claude and Cursor can manage databases directly — no copy-paste, no context switching.
Configuration
Add this to your claude_desktop_config.json or Cursor mcp.json:
{
"mcpServers": {
"basely": {
"command": "npx",
"args": ["-y", "@basely-cli/cli", "mcp"],
"env": {
"BASELY_API_URL": "https://api.basely.cc",
"BASELY_API_KEY": "your-api-key"
}
}
}
}Available tools
Example prompt
REST API
Base URL: https://api.basely.cc
Auth: pass your API key as Authorization: Bearer <key> for project routes. Account/key management routes accept a JWT from /auth/login.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /auth/signup | — | Create account |
| POST | /auth/login | — | Get JWT |
| POST | /auth/forgot-password | — | Send reset email |
| POST | /auth/reset-password | — | Reset with token |
| POST | /auth/keys | JWT | Create API key |
| GET | /auth/keys | JWT | List API keys |
| DELETE | /auth/keys/:id | JWT | Revoke key |
| GET | /projects | API key | List projects |
| POST | /projects | API key | Create project |
| DELETE | /projects/:id | API key | Delete project |
| POST | /projects/:id/query | API key | Execute SQL |
| GET | /projects/:id/schema | API key | Get schema |
| POST | /projects/:id/migrations | API key | Apply migration |
| GET | /projects/:id/migrations | API key | List migrations |
Plans & Billing
Start for free. Upgrade when you need more projects.
Hobby
Free
1 project
Indie
$5/mo
3 projects
Builder
$15/mo
10 projects
Upgrade, downgrade, or cancel anytime from the dashboard. Billing is handled securely via Stripe. Downgrades take effect at the end of your billing period.