---
title: biGENIUS-X MCP server
description: The biGENIUS-X MCP server lets an AI assistant such as Claude Code model a biGENIUS-X project and find data products in the Data Marketplace.
---

[Skip to content](https://knowledge.bigenius-x.com/bigenius-x-mcp-server#main-content)

[Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en) [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal?hsLang=en)

[![TRI\_Logo\_biGENIUS\_2020\_RGB\_s](https://knowledge.bigenius-x.com/hs-fs/hubfs/Marketing/TRI_Logo_biGENIUS_2020_RGB_s.png?width=150&height=42&name=TRI_Logo_biGENIUS_2020_RGB_s.png)](https://www.bigenius-x.com/)

Open main navigation

Close main navigation

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new)
- [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [biGENIUS-X Knowledge Base](https://knowledge.bigenius-x.com/?hsLang=en)
2. [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en)
3. [MCP server](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#mcp-server)

# biGENIUS-X MCP server

**Applies to**  
License: MCP Server

The biGENIUS-X MCP server lets an AI assistant such as Claude Code model a biGENIUS-X project and find data products in the Data Marketplace. Use it when you want to describe a model in business terms and let the assistant create the model objects. Afterwards the changed model files are in your Git repository, and you generate artifacts in biGENIUS-X as before.

The MCP server is a preview feature for organizations in the early adopter program. It covers modeling with the Modeling endpoint and queries over data products with the Data Marketplace endpoint.

### Endpoints and plugins

MCP (Model Context Protocol) is the open standard through which AI assistants call tools. The MCP server has two endpoints:

- Modeling, `https://mcp.bigenius-x.com/modeling`: tools that read and change the model of a project, for every architecture (Stage, Data Store, Data Vault, Dimensional, Data Mart). In Claude Code, the plugin `bigenius-x-modeling` adds it as the server `bigenius-modeling`.
- Data Marketplace, `https://mcp.bigenius-x.com/marketplace`: read-only tools that find data products and write SQL for their output ports. The plugin `bigenius-data-marketplace` adds it as the server `bigenius-marketplace`.

The two plugins come from the marketplace `bigenius` in the public GitHub repository [bigenius-x/claude-plugins](https://github.com/bigenius-x/claude-plugins). Each plugin contains the server entry and a skill that describes the working process to Claude; the modeling plugin also adds two hooks, scripts that decide which upload and download commands run without a prompt. Other clients, such as claude.ai, Codex and GitHub Copilot, connect the endpoints directly.

### How the work is split

- You describe what you need and confirm the plan.
- The assistant decides which model objects the plan needs and calls the tools.
- The tools write the project files the way the biGENIUS-X web app does: IDs, Default Terms, foreign key and hash key terms, mapping stubs, and the data quality rules the generator creates by default.
- biGENIUS-X generates the artifacts from the model, as before.

The generator configuration of your project, including its Advanced Settings, decides which model object types, properties and data quality rules exist. The tools read it from biGENIUS-X and refuse a type that your generator does not offer.

### When to use it

- Build a first slice of a model from a discovery, from the source to the mart.
- Extend or change an existing model, for example rename a term in every model object.
- Find the data product for a business question and get SQL for it.

### What the MCP server does not do

- It does not connect to source systems. You add source systems, discoveries and linked projects in the Discovery App and in Data Connections; the assistant tells you the steps when one is missing.
- It does not generate artifacts or deploy them. You do that in biGENIUS-X.
- It does not run queries. The Data Marketplace endpoint returns SQL, and your own tool or agent runs it on your database.
- It changes data quality rules, data classifications and project settings only when you ask: the descriptions of these tools tell the assistant so.

### Data and permissions

- You sign in with your biGENIUS-X account. The tools call biGENIUS-X with your sign-in, so the assistant gets only the access you have in the web app.
- Modeling uploads the metadata files of the project: `project.yml`, `config.yml`, `task-lists.yml`, `modelobjects/`, `views/` and `discoveries/`. It uploads no data from source systems and no other files of the repository.
- The uploaded files form a workspace on the server. The server deletes it when the assistant closes it, or after 2 hours without use. The links for upload and download are valid for 15 minutes; after that the assistant requests new ones.
- The Data Marketplace endpoint reads data products and data contracts with your sign-in. It keeps them in memory for up to 30 minutes, stores nothing and runs no queries.
- What the assistant reads (project files, tool results, your messages) is processed by its vendor under your agreement with that vendor.

### Example

Example: a data engineer has a Data Vault and Mart project with a discovery named `CRM` and asks Claude Code:

```
Build a Customer dimension from the CRM discovery.
Address changes are historized.
```

1. Claude Code uploads the project files into a workspace and reads the model objects, the discovery and the model object types of the generator.
2. It shows a plan: the model objects per layer, their business keys, relationships and historization. It waits for the data engineer's confirmation.
3. It builds the slice layer by layer, validates each layer and writes the changes into the Git working tree.
4. The data engineer reviews the diff, commits and pushes the branch, opens it in biGENIUS-X and generates the artifacts.

### Check the result

After a modeling session, `git status` lists the changed files under `modelobjects/` and `views/`. After the push, the new model objects appear in their view in biGENIUS-X.

### Related articles

- Next: [Set up Claude Code for biGENIUS-X](https://knowledge.bigenius-x.com/set-up-claude-code-for-bigenius-x?hsLang=en)
- See also: [Model a biGENIUS-X project with Claude Code](https://knowledge.bigenius-x.com/model-a-bigenius-x-project-with-claude-code?hsLang=en), [Find data products and write SQL with Claude](https://knowledge.bigenius-x.com/find-data-products-and-write-sql-with-claude?hsLang=en), [Connect other AI clients to the MCP server](https://knowledge.bigenius-x.com/connect-other-ai-clients-to-the-mcp-server?hsLang=en), [MCP server troubleshooting](https://knowledge.bigenius-x.com/mcp-server-troubleshooting?hsLang=en)

- [Getting started](https://knowledge.bigenius-x.com/getting-started?hsLang=en#main-content)

    - [Guidelines](https://knowledge.bigenius-x.com/getting-started?hsLang=en#guidelines)
    - [Start working](https://knowledge.bigenius-x.com/getting-started?hsLang=en#start-working)
    - [Account](https://knowledge.bigenius-x.com/getting-started?hsLang=en#account)
- [General overview](https://knowledge.bigenius-x.com/general-overview?hsLang=en)
- [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#main-content)

    - [MCP server](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#mcp-server)
- [Application Modules](https://knowledge.bigenius-x.com/application-modules?hsLang=en#main-content)

    - [Administration](https://knowledge.bigenius-x.com/application-modules?hsLang=en#administration)
    - [Solutions](https://knowledge.bigenius-x.com/application-modules?hsLang=en#solutions)
    - [Global Features](https://knowledge.bigenius-x.com/application-modules?hsLang=en#global-features)
    - [Projects](https://knowledge.bigenius-x.com/application-modules?hsLang=en#projects)
    - [Branches](https://knowledge.bigenius-x.com/application-modules?hsLang=en#branches)
    - [Data Connections](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-connections)
    - [Dataflow Modeling - Overview](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-overview)
    - [Dataflow Modeling - Wizard Steps](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-wizard-steps)
    - [Dataflow Modeling - Terms](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-terms)
    - [Dataflow Modeling - Term Mapping](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-term-mapping)
    - [Dataflow Modeling - Relationships](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-relationships)
    - [Dataflow Modeling - Data Quality](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-data-quality)
    - [Dataflow Modeling - Indexes](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-indexes)
    - [Relationship Modeling](https://knowledge.bigenius-x.com/application-modules?hsLang=en#relationship-modeling)
    - [Generate Artifacts](https://knowledge.bigenius-x.com/application-modules?hsLang=en#generate-artifacts)
    - [Project Settings](https://knowledge.bigenius-x.com/application-modules?hsLang=en#project-settings)
    - [Data Marketplace](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-marketplace)
- [Generators](https://knowledge.bigenius-x.com/generators?hsLang=en#main-content)

    - [Databricks](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks)
    - [Databricks dbt](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks-dbt)
    - [Fabric Lakehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-lakehouse)
    - [Fabric Warehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-warehouse)
    - [Microsoft SQL Server](https://knowledge.bigenius-x.com/generators?hsLang=en#microsoft-sql-server)
    - [Oracle](https://knowledge.bigenius-x.com/generators?hsLang=en#oracle)
    - [Snowflake](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake)
    - [Snowflake dbt](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake-dbt)
    - [Artifacts](https://knowledge.bigenius-x.com/generators?hsLang=en#artifacts)
    - [Replace Placeholders](https://knowledge.bigenius-x.com/generators?hsLang=en#replace-placeholders)
    - [Target solution environment](https://knowledge.bigenius-x.com/generators?hsLang=en#target-solution-environment)
    - [Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment)
    - [Deployment with an Azure DevOps pipeline](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment-with-an-azure-devops-pipeline)
    - [Delta Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#delta-deployment)
    - [Load control environment](https://knowledge.bigenius-x.com/generators?hsLang=en#load-control-environment)
    - [Load data with a native load control](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-a-native-load-control)
    - [Load data with Apache Airflow](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-apache-airflow)
    - [Model Object Type](https://knowledge.bigenius-x.com/generators?hsLang=en#model-object-type)
    - [Properties](https://knowledge.bigenius-x.com/generators?hsLang=en#properties)
    - [Default Terms](https://knowledge.bigenius-x.com/generators?hsLang=en#default-terms)
- [Discovery application](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#main-content)

    - [Discovery configurations](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#discovery-configurations)
- [Best practices](https://knowledge.bigenius-x.com/best-practices?hsLang=en#main-content)

    - [Modeling Approaches](https://knowledge.bigenius-x.com/best-practices?hsLang=en#modeling-approaches)
    - [Use Cases](https://knowledge.bigenius-x.com/best-practices?hsLang=en#use-cases)
    - [Business Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#business-rules)
    - [Data Quality Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#data-quality-rules)
- [FAQs](https://knowledge.bigenius-x.com/faqs?hsLang=en)
- [Product Release Notes](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#main-content)

    - [SaaS Application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#saas-application)
    - [Discovery application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#discovery-application)
    - [Generators](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#generators)
- [Legal Documents](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#main-content)

    - [Current legal docs](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#current-legal-docs)
    - [Software Product and Limits](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#software-product-and-limits)

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en)
- [Customer Portal](https://knowledge.bigenius-x.com/customer-portal)
- [Sign in](https://knowledge.bigenius-x.com/_hcms/mem/login)

[![biGENIUS logo](https://knowledge.bigenius-x.com/hubfs/TRI_Logo_biGENIUS_2020_RGB-1.svg "biGENIUS logo")](https://www.bigenius-x.com)

<https://www.linkedin.com/company/bigenius> <https://www.youtube.com/@biGENIUS_DWA>

All rights reserved © 2025, biGENIUS AG