> ## Documentation Index
> Fetch the complete documentation index at: https://docs.margovia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Track AI cost, customer attribution, and outcome economics from Node.js apps.

Margovia helps SaaS teams understand whether AI features are profitable by customer, plan, and workflow.

The JavaScript SDK is the small tracking library you install in your backend. Put it next to the code that already calls OpenAI, Anthropic, or another model provider. It sends usage and attribution events to Margovia.

Installing the SDK alone does not send anything. Add `MARGOVIA_API_KEY` when you are ready to send events to Margovia Cloud. Set `MARGOVIA_BASE_URL` only for local development, self-hosting, or a compatible receiver.

## What the SDK captures

* AI workflow or feature name
* User, customer, and account identifiers
* Customer plan and plan revenue
* Provider and model
* Token usage, cache usage, and reasoning tokens
* Manual or provider-reported cost
* Outcomes and business value

The SDK does not call model providers for you. Your app still owns the OpenAI, Anthropic, or other provider request. Margovia records what happened and shows it in the dashboard.

## Where it runs

Use the SDK in backend code only:

* Next.js route handlers and server actions
* Express, Fastify, Hono, and Remix actions
* Worker queues and background jobs
* Internal tools that call model providers

Do not use the SDK in browser code. `MARGOVIA_API_KEY` is a backend secret.

## Open source boundary

Margovia is a commercial product for AI gross margin reporting, budgets, customer profitability, and plan margin analysis.

The SDK is open source because instrumentation should be inspectable, portable, and easy to remove or replace.