Quick start
From signup to a working API call in under five minutes.
1. Create an account
Sign up at jaina.dev. No credit card required.
2. Create a project
After signup you land on /projects. Click New project, give it a name and a slug.
The slug is what your API and CLI use. Keep it short and URL-safe — my-game, marketing-site, device-fleet.
3. Define a schema
In your project's workspace, the Schemas pane is the second column. Click New schema.
A schema is a typed shape. For a game project, you might define an Enemy:
| Field name | Type | Notes |
|---|---|---|
name | text | required |
hp | number | required, integer, min 1 |
attack | number | required, integer |
sprite | file | accept image/* |
4. Create a package
Records live inside a package, so a fresh project needs at least one. In the Packages pane, click New package and give it a name (for example, level-1).
A package is a container for records. You can use a single package for everything, or split records into several (levels, environments, content sets).
5. Add records via GUI
Select your package and schema, then in the Instances pane click New instance. The form is generated from your schema. Fill it in, save it.
6. Access via API
Get an API token at /settings/tokens → Create token. Then:
curl https://jaina.dev/api/v1/projects/my-game/schemas/enemy/records \
-H "Authorization: Bearer jn_live_..."
You'll get back JSON with your enemies.
7. Access via MCP
MCP works on the Free plan — read and write. Browse, export, generate code, create schemas, and add records through MCP for free, so the "list my projects" step below works right away. Free is bounded by volume (100 requests/hour and the Free quotas), not access; Pro ($9.99/mo) raises the limits and adds actions and webhooks. See pricing.
Add to your Claude Desktop MCP config:
{
"mcpServers": {
"jaina": {
"type": "http",
"url": "https://jaina.dev/api/mcp",
"headers": { "Authorization": "Bearer jn_live_..." }
}
}
}
Restart Claude Desktop. Ask: "list my Jaina projects." Claude calls jaina_list_projects and shows you the result.
For Claude Code, add the server with the CLI instead:
claude mcp add --transport http jaina https://jaina.dev/api/mcp \
--header "Authorization: Bearer jn_live_..."
Next steps
- Core concepts — schema, field, record, package.
- Your first schema — a longer walkthrough.
- SDK docs — strongly-typed clients for TS, C#, and Python.
