explainx.ai350K+ learn from us
TrendingAI News TodayPathwaysSkills
Pricing
explainx.ai

Upskill in AI — 16 free pathways, live workshops & bootcamps, and 50+ courses from practitioners. Plus the skills, tools, and MCP servers to practice on.

follow us

follow on google

Add explainx.ai as a preferred source

corporate training

support@explainx.ai

get started

Find your pathTake Free Evaluation

community

Join the community

learn

mind: share how you thinkpathways — start freeworkshopsbootcampscoursescompare Explainxcertificationsmock testsexplainx universitycorporate traininglearn skills & mcp

discover

skillsmcp serversexplainx mcpestacktoolsmdx readeragentsllmsdesignsdictionarypeopleagi trackerfelony benchranks

company

aboutvisionmissionteaminstructorsteach on explainxpartnershipscommunityhackathonscareers

content

daily AI newsstate of AI — live resultsblogreleasespromptsgeneratorsresource libraryfor LLMsexplainx.ai kids

solutions

all solutionsdeveloper upskillingmarketing upskillingproduct manager upskillingleadership upskilling

newsletter · weekly

Get AI news, tools, and insights in your inbox.

supportcontactprivacytermsdata rightshow we create contentsubmission guidelines

© 2026 AISOLO Technologies Pvt Ltd

explainx.ai

On this page

  • TL;DR
  • What problem is this solving?
  • How is it built?
  • Which models does it use?
  • How do agents talk to it?
  • How do you try it?
  • What do the agent skills add?
  • How does it compare with other ontology tools?
  • What are the limits?
  • What developers are saying
  • Update, November 9: where the skeptics push back
  • What this means for what you build
  • Related reading
← Back to blog

explainx / blog

NVIDIA Auto Ontology: An Open-Source Context Layer That Tells Agents What Your Data Means

NVIDIA, AI Agents, MCP, Open Source, Data

Part of AI Chips and Infrastructure

NVIDIA Auto Ontology is an Apache-2.0 repo that builds a semantic layer over your databases and serves it to agents over MCP. What it does, how to run it, limits.

Nov 3, 2026·13 min read·Yash Thakker
add explainx.ai
go deep
NVIDIA Auto Ontology: An Open-Source Context Layer That Tells Agents What Your Data Means

NVIDIA has published Auto Ontology, an Apache-2.0 framework that builds a business-meaning layer over your databases and serves it to AI agents through MCP, a CLI and an API. The repository on GitHub had about 10,300 stars when we updated this post on November 9, 2026, up from roughly 1,100 stars on launch week, with a large Hacker News thread following.

The pitch is blunt. In NVIDIA's words, "reliability gates agentic analytics: a revenue metric answered faster is worth nothing if the number is wrong." Auto Ontology tries to give an agent the context a new analyst would need: where data lives, what a term means, whether to trust it, and where it came from.

TL;DR

table · 2 cols
QuestionAnswer (from the README and docs)
What is it?A framework that builds an ontology and semantic catalog from enterprise metadata, then serves it to agents
LicenseApache License 2.0
How do agents reach it?MCP server, CLI, and an HTTP API
Default modelsNemotron 3 Nano 30B A3B (LLM), Nemotron 3 Embed 1B, Llama Nemotron Rerank VL 1B v2, all via NVIDIA NIM
Source databasesDatabricks, Postgres, Snowflake, DuckDB
StoragePostgres with pgvector holds the catalog, ontology and vectors
DeploymentDocker Compose locally, Helm chart for Kubernetes
Outside contributionsNot accepted at this time
Needs an API key?Yes, an NVIDIA key (nvapi-...) for the default hosted NIM endpoints

What problem is this solving?

Anyone who has pointed an LLM at a data warehouse has seen the failure. The model writes valid SQL against the wrong table, or picks the wrong definition of "active customer," or joins two systems that count revenue differently. The query runs. The number looks plausible. It is wrong.

Text-to-SQL has been a research topic for years, and benchmarks such as BIRD measure it. We covered one recent entry in Google's Gemini SQL2 text-to-SQL results on BIRD. But benchmark schemas are small and clean. Enterprise warehouses have thousands of tables, three definitions of every metric, and tribal knowledge nobody wrote down.

Auto Ontology's answer is a context layer between the agent and the database. The README breaks it into five verbs:

  • Discover. Generate enterprise ontologies from metadata, connect existing ontologies and semantic models, and build AI-ready knowledge graphs.
  • Ground. Give agents trusted business meaning for metrics, entities and relationships, and reconcile inconsistent definitions across systems.
  • Validate. Check generated queries against certified definitions and lineage, and return provenance with every answer.
  • Expose. Serve context to any agent harness through MCP, CLI and API.
  • Learn. Fold certified corrections and usage back into the ontology, so the shared context improves with every question.

NVIDIA also says the tool "complements the semantic models customers already own." That matters. It is not asking you to throw away a dbt semantic layer or a Databricks metric view. It reads and reconciles them.

How is it built?

The README lists four main components.

table · 4 cols
ComponentTechnologyRoleDefault port
FrontendNext.js 16, React 19, TypeScript, Tailwind CSS 4, Better Auth, PrismaWeb UI, authentication, API gateway3000
BackendFastAPI on Python 3.12+, LangChainChat and NL-to-SQL, catalog, datasource APIs3001
Ingestion workerFastAPIIngests tabular data, writes embeddings3002
Postgres with pgvectorRelational databaseApp metadata, the catalog and ontology, vector store5432

HashiCorp Vault is optional, for storing connection credentials. The web UI covers chat, analysis, a data catalog, analytics and settings. Authentication supports SSO, with the redirect URI set to APP_URL/api/auth/sso/callback.

A table grid with a green funnel selecting a few rows, standing for how NVIDIA Auto Ontology narrows text-to-SQL queries to certified definitionsA table grid with a green funnel selecting a few rows, standing for how NVIDIA Auto Ontology narrows text-to-SQL queries to certified definitions

The design choice worth noticing is that the semantic catalog lives in Postgres "alongside the catalog it describes." The ontology is not a separate graph database you must also operate. Vectors, terms and metadata share one store.

Which models does it use?

Auto Ontology calls NVIDIA NIM endpoints for inference, either the hosted API catalog at integrate.api.nvidia.com or self-hosted NIMs. The defaults in .env.example are:

  • LLM: nvidia/nemotron-3-nano-30b-a3b
  • Embeddings: nvidia/nemotron-3-embed-1b
  • Reranking: nvidia/llama-nemotron-rerank-vl-1b-v2

Each model role is a triplet of environment variables: <PREFIX>_ENDPOINT, <PREFIX>_API_KEY and <PREFIX>_MODEL. The prefixes are DEFAULT_MODELS, REASONING, NON_REASONING, EMBED and RERANK. Any field you leave unset falls back to the matching DEFAULT_MODELS_ field, so the simplest setup fills in only the defaults.

Because the endpoint is just a URL, the README says any OpenAI-compatible model endpoint works. In practice that means you can point the reasoning role at a stronger model and keep small Nemotron models for extraction and embeddings. This matches NVIDIA's recent push for small, cheap models in agent pipelines, which we followed in Nemotron 3.5 Lightning, a 30B A3B open MoE and the Nemotron 3 Ultra 550B release.

One caution: the README's disclaimer says the software "automatically retrieves, accesses or interacts with external materials," and that you are responsible for the terms of the hosted NVIDIA APIs, any other model endpoint you configure, and your source databases. An optional KumoRFM predictive-query service activates only when KUMO_RFM_API_KEY is set.

How do agents talk to it?

The MCP server is the part most readers will care about. According to the repo's MCP documentation, it is an HTTP client of the public Auto Ontology API. It holds no database credentials, no model configuration and no credentials of its own. Authentication and permission checks stay in the Next.js layer, so "a session can do exactly what the person behind it can do — a viewer gets a viewer's answers."

For background on the protocol, see our MCP explainer.

A key fitting a narrow opening in a fence, illustrating how Auto Ontology MCP sessions inherit the permissions of the signed-in userA key fitting a narrow opening in a fence, illustrating how Auto Ontology MCP sessions inherit the permissions of the signed-in user

The tool list

Every tool is read-only. Nothing changes the glossary, the catalog or the databases.

table · 2 cols
ToolPurpose
ask_questionThe primary tool. Plain-language question in; answer, the SQL that ran, and the rows out
check_answerableGrades whether the semantic layer covers a question, as a cheap pre-flight
check_readinessWhether the deployment can answer anything at all
search_termsSearches the business glossary
get_termOne term with description, synonyms and related terms
get_term_columnsThe physical columns a term maps to
get_term_sql_attributesThe SQL attributes defined under a term
get_sql_attributeOne SQL attribute, its expression and purpose
describe_tableA table's columns, related terms and SQL attributes together

The docs say there is "deliberately no tool for browsing databases, schemas, or raw columns." The authors want agents to reach data through the semantic layer, because a raw catalog browser "invites an agent to reason about raw tables instead." That is a sound design rule, and a useful pattern for anyone building their own MCP servers: expose meaning, not plumbing.

What ask_question really does

It calls POST /api/chat/completions, the same endpoint the web UI uses. That runs the full text-to-SQL agent, which means many sequential model calls and, per the docs, "typically tens of seconds." The result comes back as separate fields for answer, SQL and rows, so an agent can reuse the SQL without parsing prose. Results are capped at 100 rows, with row_count and truncated fields reporting what was withheld. The server also emits MCP progress notifications while the agent works.

The default chat timeout in the MCP server is 900 seconds. Plan for slow calls.

Why check_readiness exists

This is a candid piece of the docs. A deployment needs two independent things: a compiled semantic layer and a live database connection. Having one without the other is "the most misleading state, because everything looks healthy" while every question fails "expensively and vaguely, after minutes of model calls." The tool reports every blocker at once. Any team that has debugged an agent that silently returns empty answers will recognize the problem.

How do you try it?

Two routes: Docker Compose for a local stack, or a Helm chart for Kubernetes (see DEPLOYMENT.md in the repo).

  1. Clone the repository.
  2. Copy .env.example to .env. Set the Postgres credentials, DEFAULT_MODELS_API_KEY, and CONNECTION_STRINGS for your source database.
  3. Set AUTH_SECRET and APP_URL. Without them, every page fails with a Better Auth "default secret" error.
  4. Run docker compose up -d --build.
  5. Open http://localhost:3000. The API is on :3001.

You need Docker with Compose v2 and an NVIDIA API key from build.nvidia.com. If the UI loads without its left navigation panel after a restart, clear the site cookie for localhost:3000; NVIDIA says a stale session cookie causes it when AUTH_SECRET changes or the database resets.

For scripts and notebooks, mint an API token from the user menu and send it as x-api-key or as a Bearer token. Tokens are stored only as a SHA-256 hash and act as their owner, with no extra permissions. Deleting the token or banning the user revokes access on the next request.

To wire the MCP server into a client, run it with the URL of your deployment:

sh
AUTO_ONTOLOGY_API_URL=https://auto_ontology.example.com auto-ontology-mcp

Then point the client at the /mcp endpoint. The docs note that the client signs in through Auto Ontology's own login page and registers itself automatically, so there is nothing to register with an identity provider.

A note on the install instructions

The MCP doc says something worth flagging: "Auto Ontology is NVIDIA-internal today, so this install needs GitHub credentials with access to the repository." The uvx command installs straight from GitHub, and the plain uvx auto-ontology-mcp form will work "once the package is published to PyPI." The repository is public, so the note may simply be left over from before release. Treat the package route as unfinished and install from the repo.

What do the agent skills add?

The repo has an AGENTS.md for coding agents and a skills/ folder with three skills: nvidia-ontology-setup, nvidia-ontology-management and nvidia-ontology-query. A separate CLAUDE.md is for the maintainers themselves. So you can hand a coding agent the repo and ask it to set up the stack, manage the ontology, or query it. If you are new to the format, our guide to agent skills explains how they work.

How does it compare with other ontology tools?

Several projects chase the same gap, which tells you it is a real one:

  • Helix Foundry turns company data into an agent-drafted graph. It leans toward drafting the graph with agents.
  • Sakana Aquarium uses an ontology as the governance base for managed enterprise agents.
  • Graphify builds a knowledge graph of a codebase, not business data.

Auto Ontology sits closest to the first two but is narrower and more SQL-centered. Its stated job is to make generated queries match certified definitions and to return provenance with every answer. Its largest difference is the vendor. NVIDIA has hardware and model reasons to promote agent workloads that call many small-model steps, and the defaults show it.

What are the limits?

Based on what the README and docs say:

  • Heavy to run. Four services plus Postgres is a lot for a pilot. Expect to read DEPLOYMENT.md.
  • Credential storage. Connections added through the UI keep the full connection object, password included, unencrypted in the catalog row unless Vault is fully configured. A partial Vault configuration is ignored with a warning and falls back to plaintext. Use the CONNECTION_STRINGS route or set up Vault first.
  • No accuracy figures. The README points to a separate "ontology SQL evaluation repository" for BIRD-style runs. It gives no scores. Until someone runs it, treat reliability claims as untested.
  • No outside contributions. "Issues, pull requests, and patches submitted from outside the Auto Ontology maintainer team will not be reviewed or merged." You can fork under Apache-2.0, but you cannot count on upstream fixes.
  • Slow answers. Tens of seconds per question is fine for analytics, bad for chat.
  • Read-only MCP. Safe by default, but corrections must go through the web UI or API.

What developers are saying

The Hacker News thread had roughly 291 points and 139 comments when we read it on November 9, 2026, a week after the quiet launch week. The repo itself climbed past 10,000 GitHub stars in the same period, so the discussion is now a real install-or-skip debate, not just a headline bump.

campervans called it a game changer for enterprise technical debt, framing semantic layers as paydown work rather than novelty. grey-area argued the pitch sounds like fixing unreliable agents by stacking more unreliable agents, and that LLMs blur training data, instructions, and the tables under analysis unless the harness hard-separates them. podocarp asked how this differs from a memory system plus API-collecting skills, a fair question for anyone already running MCP tool registries.

gavinray posted a plain-language summary: scattered databases, executives asking ad hoc questions, analysts writing SQL — Auto Ontology tries to put certified definitions in front of the LLM before generation. fnordpiglet compared the design to OWL, RDF, and SPARQL, wondering whether the semantic-web stack already solves the problem with more maturity. smithclay linked UC Berkeley's DataAgentBench leaderboard as a place to see how closed and open data agents score when they must query multiple sources.

Update, November 9: where the skeptics push back

Skepticism is loud too. igleria stopped at the default NVIDIA NIM API key requirement. dstu bounced off README AI marketing tone and the word gates. Catloafdev tapped out at README AI-isms; barrrrald said the README and diagram did not explain the mechanics to ontology veterans. ex1fm3ta compared the pitch to Palantir's core business; skinfaxi asked whether it was vibe-coded Palantir — opinion, not a product review, but it signals procurement friction.

Treat every comment as opinion or analogy, not a benchmark. The actionable thread for builders is the grey-area worry: without strict separation between glossary facts, user questions, and raw rows, a semantic layer can still hallucinate joins. That is why read-only MCP tools plus human-visible SQL matter in this design.

What this means for what you build

If you build internal analytics agents, the lesson is portable even if you never run this repo. An agent needs a layer that carries definitions, lineage and permissions. Start with a glossary of the 20 metrics your business argues about. Map each to the columns and SQL that define it. Give the agent tools that search that glossary before any tool that touches raw tables. Return the SQL and the rows with every answer so a human can check.

If you handle sensitive data, watch the permission model. The design where an MCP session inherits the signed-in user's role is the right one, and it is the opposite of one shared service token. For deeper guardrails on what agents can do with tools, AgentBeam is the agent security platform from the explainx.ai team.

If you want to benchmark it, run the evaluation repo on your own schema, not on BIRD alone. Public benchmarks reward clean schemas. Your warehouse is not one.

Related reading

  • Google's Gemini SQL2 and BIRD
  • Helix Foundry: open-source company data ontology
  • Sakana Aquarium ontology platform
  • Graphify codebase knowledge graph
  • What is MCP?
  • What are agent skills?
  • Nemotron 3.5 Lightning

Details are accurate as of November 9, 2026. The repository changes often, so check the README before you deploy.

Spotted something out of date? Let us know.
Daily briefFrom Yash · 350K+ students taught

Catch up on AI

One AI story explained in plain English, plus one thing to try. Every day, free. Unsubscribe anytime.

  • ✓ Free
  • ✓ One email a day, no spam
  • ✓ Unsubscribe anytime
Yash Thakker

Written by

Yash Thakker

Yash is an AI expert with over 300K learners. Join his workshops →

View Yash Thakker in People in AI →

Related posts

Nov 5, 2026

Executor 2 Beta: One Open-Source MCP Gateway for Claude Code, Cursor and Codex (MIT, 4.3k Stars)

Executor, the open-source integration layer from Rhys Sullivan and UsefulSoftwareCo, entered its 2.0 beta this week, with new builds on November 3, 4 and 5, 2026. It puts MCP servers, OpenAPI specs and GraphQL APIs behind one catalog with allow, approve or block policies, so Claude Code, Cursor and Codex share the same tools. Here is what it does, how to install the beta, and what to check before you trust it with your accounts.

Nov 4, 2026

NVIDIA AI Factory Operations Agent: How Six MCP Sub-Agents Run DGX SuperPOD Troubleshooting

NVIDIA published the design of the agent its site reliability engineers use on DGX SuperPOD clusters. Six domain agents talk over MCP, run in OpenShell sandboxes, and use local Nemotron models. The framework is experimental open source. Here is how it works, what NVIDIA does not say, and how to try it.

Nov 4, 2026

NVIDIA FOX Blueprint: A Factory Manager Agent That Traces Defects to Their Cause

NVIDIA published the Factory Operations Blueprint (FOX), a reference architecture for a long-running factory manager agent. It follows one circuit-board defect from an inspection alert to a root-cause PDF, with human review built in. Here is how the pieces fit and what NVIDIA does and does not claim.