> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://dev.neurologyca.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://dev.neurologyca.com/_mcp/server.

# Getting Started

> Use your integration goal to choose between SoftSkills, Agents, and Engine.

This page is the fastest way to decide which Neurologyca API you should integrate with. Start with the user experience you want to build, then follow the corresponding section for setup details and endpoint-level documentation.

## Start with your use case

#### [I have a recorded video](/softskills-getting-started)

Use the SoftSkills API if you want to upload one completed video file and receive structured feedback.

#### [I want a coaching chat](/agents-overview)

Use the Agents API if you want sessions, conversation history, and assistant replies in your app.

#### [I process live sessions](/engine-overview)

Use the Engine API if your workflow uploads session packages over time and retrieves final analysis later.

## Choose the right integration path

| If your use case is...                                       | Choose this API    | Why                                                                                     | First endpoint               |
| ------------------------------------------------------------ | ------------------ | --------------------------------------------------------------------------------------- | ---------------------------- |
| Upload a single recorded presentation or practice video      | **SoftSkills API** | Simplest external integration for recorded-video analysis with sync-or-async completion | `POST /api/v1/full-analysis` |
| Add a Neurologyca-powered assistant or coach to your product | **Agents API**     | Supports session creation, history retrieval, and traced responses                      | `POST /api/v1/auth/firebase` |
| Run a live or step-based assessment pipeline                 | **Engine API**     | Built for session creation, `.kpn` processing, and final Constellation insights         | `POST /session`              |

## Decision guide

### Use SoftSkills API when

* Your app already has a finished video file.
* You want a JSON response with video analysis and biometric outputs from a single upload flow.
* You prefer an API-key-based integration with minimal state management.

Read next: [SoftSkills Getting Started](/softskills-getting-started)

### Use Agents API when

* You are building a conversational UI.
* You need persistent sessions and conversation history.
* You want the assistant reply plus per-agent traces from the orchestration layer.

Read next: [Agents Overview](/agents-overview)

### Use Engine API when

* You capture session data incrementally instead of sending one final file.
* Your client can produce `.kpn` packages.
* You need a session token first, then upload processing inputs, then fetch final analysis.

Read next: [Engine Overview](/engine-overview)

## What you will need before integrating

* **SoftSkills API:** a Neurologyca API key from the dashboard and a supported video file.
* **Agents API:** an authenticated user flow that can send bearer tokens to the Agent backend.
* **Engine API:** tenant credentials for `POST /session` and the ability to upload `.kpn` packages.

## Suggested next step

1. Pick the API that matches your product flow, not just the data format you have today.
2. Read that section's overview page to understand the workflow and authentication model.
3. Move into the API reference once you are ready to implement endpoint calls.