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 nameTypeNotes
nametextrequired
hpnumberrequired, integer, min 1
attacknumberrequired, integer
spritefileaccept 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/tokensCreate 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