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

# Introduction

> Narev maintains real-time LLM pricing. Pull rates over REST or MCP, bill AI SDK usage, or ship the catalog into your warehouse.

> For AI-driven implementation, read the following resources immediately:
>
> 1. **Model Context Protocol (MCP) server:** `https://www.narev.ai/docs/mcp` (search and fetch documentation).
> 2. **Skills:** `npx skills install narevai/skills` (execute specific workflows).
> 3. **Index of all pages:** `https://www.narev.ai/docs/llms.txt` (fetch documentation and guides, identify relevant Cloud, SDK, or Self-Hosted paths, then read full pages before answering).

<Frame>
  <img src="https://mintcdn.com/narev/5d-dVsERtsYrWOXW/images/intro.png?fit=max&auto=format&n=5d-dVsERtsYrWOXW&q=85&s=e57715a594b1bcaa2950511c71fc31d2" alt="Narev introduction hero image" width="1035" height="553" data-path="images/intro.png" />
</Frame>

Narev maintains **the most carefully maintained**, real-time LLM pricing. You can use it to:

* deploy your own AI gateway
* bill your users per token, request, or usage
* run AI cost observability platforms

## Problems Narev solves

<AccordionGroup>
  <Accordion title="My static price tables are stale" icon="coins">
    LLM prices change hourly now. Unless you scrape them in real time, you're behind.

    Narev keeps a live price catalog you can trust and bill against.
  </Accordion>

  <Accordion title="I need to show my users the cost of their usage" icon="route">
    Token counts alone don't tell you cost per request.

    Either send us a request with token counts to `/calculate` or pull our data to your pricing map.
  </Accordion>

  <Accordion title="Lago, OpenMeter, Stripe, Polar don't have LLM pricing" icon="route">
    Lago, OpenMeter, Stripe, Polar don't maintain LLM pricing.

    Narev has the most carefully maintained real-time LLM pricing and a set of tools to help you send dollar usage.
  </Accordion>

  <Accordion title="I run my own gateway and I need pricing catalog" icon="route">
    You need a price map you own, not whatever estimate another gateway baked in.

    Set custom prices in Narev Cloud and push those rates into your gateway and tooling.
  </Accordion>

  <Accordion title="Vercel AI SDK usage has no dollar amount" icon="plug">
    Token counts alone don't tell you cost per request.

    ai-billing middleware resolves cost on the generation and can show usage in the UI.
  </Accordion>
</AccordionGroup>

## Getting started

### Bare metal

<CardGroup cols={3}>
  <Card title="REST API" icon="brackets-curly" href="/docs/platform/api-reference/overview">
    `GET` providers, models, and prices. `POST` cost calculation. No SDK required.
  </Card>

  <Card title="MCP" icon="robot" href="/docs/quickstart-agents">
    Wire an agent to `https://mcp.narev.ai` for live prices and docs.
  </Card>

  <Card title="GitHub App" icon="github" href="https://www.narev.ai/sales">
    If LLM prices live as constants in a repo, the app opens PRs when rates change.
  </Card>
</CardGroup>

### TypeScript

<CardGroup cols={2}>
  <Card title="Vercel AI SDK" icon="bolt" href="/docs/quickstart">
    Wrap `generateText` / `streamText` with `@ai-billing/*` middleware and send usage to Polar or Stripe.
  </Card>

  <Card title="SDK" icon="code" href="/docs/sdk/ai-billing/index">
    Provider middleware, price resolvers, and billing destinations in `@ai-billing/core`.
  </Card>
</CardGroup>

## Building something bigger?

When the public API isn't enough, Narev ships the catalog into your pipelines.

<CardGroup cols={2}>
  <Card title="WebSockets" icon="wifi" href="https://www.narev.ai/sales">
    Stream price updates as rates change. Keep gateways and caches hot without polling.
  </Card>

  <Card title="S3" icon="box" href="https://www.narev.ai/sales">
    Land full catalog dumps in object storage for your own loaders and lakes.
  </Card>
</CardGroup>

## Working with a data warehouse?

<CardGroup cols={3}>
  <Card title="Fivetran" icon="database" href="https://www.narev.ai/sales">
    Managed ELT. Sync the Narev price catalog into Snowflake, BigQuery, or Redshift on a schedule.
  </Card>

  <Card title="Airbyte" icon="database" href="https://www.narev.ai/sales">
    Open-source or Cloud ELT. Pull catalog rows into the warehouse you already run.
  </Card>

  <Card title="Meltano" icon="database" href="https://www.narev.ai/sales">
    Singer-based pipelines. Version the extract and load of Narev prices in git with your other jobs.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.