Skip to main content

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.

Give agents direct access to Narev Docs

Use the Narev Docs MCP server to let AI agents search this documentation while they work. Instead of relying on web search or stale model knowledge, your agent can query the current Narev Cloud, Narev SDK, and Narev Self-Hosted docs through Model Context Protocol (MCP).
The public Narev Docs MCP server runs at https://www.narev.ai/docs/mcp.

Search current docs

Ask questions about billing integrations, benchmarking, API usage, and concepts.

Read exact pages

Let agents fetch source documentation before suggesting implementation steps.

Reduce hallucinations

Ground answers in the docs your team maintains in this repository.

Available MCP functions

The Narev Docs MCP server exposes documentation-focused tools. Tool names can appear slightly differently across MCP clients, but the capabilities are the same.
FunctionWhat it doesUse it for
SearchSearches indexed Narev Docs pages and returns relevant snippets, titles, and links.Finding the right guide or API page from a natural-language question.
Query docs filesystemReads and navigates the docs as a virtual filesystem with shell-style commands.Fetching full page content, browsing docs structure, or reading specific sections.
The search function supports optional filters such as pageSize, scoreThreshold, version, and language when your MCP client exposes them.
A good agent workflow is: search first, read the most relevant pages, then answer or edit code using those docs as context.

Before you start

You need:
  • An MCP-compatible client, such as Cursor, Claude Code, Claude Desktop, or VS Code.
  • Network access to https://www.narev.ai/docs/mcp.
  • No API key for public Narev Docs content.
Don’t send secrets or private customer data in documentation search prompts. The public MCP endpoint is for documentation retrieval.

Connect your agent

1

Add the Narev Docs MCP server

Configure your MCP client with this remote HTTP endpoint:
https://www.narev.ai/docs/mcp
Add this server in Settings → MCP, or add it to your MCP configuration:
~/.cursor/mcp.json
{
  "mcpServers": {
    "narev-docs": {
      "url": "https://www.narev.ai/docs/mcp"
    }
  }
}
Restart MCP servers from Cursor settings after saving the file.
2

Verify the tools are available

Open your client’s MCP tools list and confirm that the Narev Docs server exposes documentation search and docs filesystem query tools.Ask a test question such as:
Search Narev Docs for how to connect Polar billing.
The agent should return pages such as the Polar billing integration, Next.js billing integration, or Narev SDK overview.
3

Use the docs during implementation

Ask your agent to consult Narev Docs before changing billing, benchmarking, or API code.Example prompts:
Use Narev Docs to find the recommended Next.js billing integration pattern, then inspect the app and suggest the smallest change.
Search Narev Docs for custom quality metrics and show the request body for submitting a metric.
Read the Narev SDK docs for price resolvers and explain when to use the NAREV_API_KEY.

What agents can answer with MCP

After connection, agents can retrieve documentation for common Narev workflows:
  • Narev Cloud billing: Framework adapters, billing platforms, Customer Tagging, and usage-based billing concepts.
  • Narev SDK: Provider middleware, destinations, price resolvers, and package reference pages.
  • Benchmarking: Benchmark creation, variants, data sources, integrations, and result analysis.
  • API usage: Pricing lookup, model cost calculation, chat completions, and custom quality metrics.
  • Narev Self-Hosted: Infrastructure cost mapping and FOCUS format docs when the search index includes those pages.

Troubleshooting

Open https://www.narev.ai/docs/mcp through an MCP client, not a browser GET request. The endpoint expects MCP JSON-RPC calls over HTTP.
Confirm the server URL is exactly https://www.narev.ai/docs/mcp. Then restart your MCP client or reload MCP servers from the client settings.
Mintlify indexes pages that the docs.json navigation includes by default. Confirm the page is public and appears in the docs navigation.
Ask the agent to search Narev Docs first, then read the most relevant page before answering. This nudges the agent to use MCP instead of its built-in knowledge.

Next steps

AI billing quickstart

Set up Narev Cloud, the Narev SDK, Customer Tagging, and Polar billing.

Next.js billing integration

Add metered AI billing to a Next.js App Router app.

Narev Cloud API reference

Review pricing, app completions, and custom metric endpoints.

Benchmarking quickstart

Compare model quality and cost with Narev Cloud benchmarks.