MCP Server

The Qarion MCP Server implements the Model Context Protocol (MCP), allowing LLM-based agents like Claude, Cursor, and Windsurf to interact with the Qarion platform directly. It wraps the Python SDK and exposes 373 tools covering the Qarion SDK surface for agent integration.

Installation

cd mcp-server
pip install -e .

Configuration

Set one authentication environment variable before starting the server. Use QARION_API_KEY for service-style access, or QARION_BEARER_TOKEN when the agent should act with user-context authorization.

Variable	Required	Description
QARION_API_KEY	Yes, unless bearer token is set	Qarion API key for service-style auth
QARION_BEARER_TOKEN	Yes, unless API key is set	Bearer token for user-context auth
QARION_BASE_URL	No	Override the target Qarion API base URL

Running

# Via module
python -m qarion_mcp

# Via entry point
qarion-mcp

Client Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "qarion": {
      "command": "python",
      "args": ["-m", "qarion_mcp"],
      "env": {
        "QARION_API_KEY": "qk_your_api_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add an MCP server entry in your IDE settings pointing to python -m qarion_mcp with either QARION_API_KEY or QARION_BEARER_TOKEN set.

Coverage and Tool Design

The MCP server exposes 373 registered tools backed by the Qarion Python SDK. SDK coverage is tracked in a machine-readable manifest so every async SDK method is either exposed to MCP or explicitly excluded.

High-value domains such as source systems, incidents, integrations, connectors, product alerts, and quality workflows use typed, agent-friendly tool signatures. Lower-value long-tail SDK methods may still be exposed through the generic parity layer with a payload object.

Safety and Confirmation

Read-only lookup, list, and search tools are classified as read and can run without confirmation. Tools that create or update data are classified as write; delete, archive, remove, resolve, cancel, and unpublish tools are classified as destructive; webhook tests, integration syncs, downstream notifications, and similar operations are classified as external_side_effect.

The in-platform copilot requires confirmation for write, destructive, and external_side_effect tools. Credential and secret material is redacted from MCP responses, including fields such as secret, password, token, and api_key.

Available Tools

The server currently registers the following MCP tools. Tools that write data, delete/archive resources, or trigger external side effects are classified in the AI capability registry and require confirmation in the in-platform copilot.

Tool	Description
add_downstream_product	Add downstream product via the Qarion SDK.
add_lineage_edge	Add a manual lineage edge between two products.
add_space_organization	Add space organization via the Qarion SDK.
add_steward_domain	Add steward domain via the Qarion SDK.
add_team_member	Add a user to a team.
add_upstream_product	Add upstream product via the Qarion SDK.
add_user_organization	Add user organization via the Qarion SDK.
allocate_manual_costs	Apply allocation rules to unattributed manual cost line items.
annotate_alert	Add an annotation to an alert.
apply_ce_marking_conformity_assessment	Apply ce marking conformity assessment via the Qarion SDK.
apply_quality_config	Apply quality config via the Qarion SDK.
approve_workflow	Approve or reject a workflow approval step.
archive_contract	Archive a data contract.
archive_cycle_recertification_cycle	Archive cycle recertification cycle via the Qarion SDK.
assign_product_domain	Assign product domain via the Qarion SDK.
browse_marketplace	Browse published data marketplace listings.
cancel_recertification_cycle	Cancel a recertification cycle.
check_integration_quality_gate	Check whether a product passes an integration quality gate.
check_permission	Check whether the current user can perform an action.
complete_recertification_cycle	Mark a recertification cycle as completed.
complete_review_conformity_assessment	Complete review conformity assessment via the Qarion SDK.
complete_risk_assessment	Complete a risk assessment and optionally sync tier to product.
create_audit_request_recertification_cycle	Create audit request recertification cycle via the Qarion SDK.
create_change_request	Create a change request for a data product.
create_conformity_assessment	Create a new conformity assessment for a product.
create_connector	Create a connector in a space.
create_contract	Create a new data contract.
create_credential	Create a global credential.
create_domain	Create a new data domain.
create_for_product_issue	Create for product issue via the Qarion SDK.
create_form_instance	Create a form instance.
create_form_template	Create a form template.
create_glossary_term	Create a new business glossary term.
create_issue	Create a new issue ticket.
create_manual_cost_finops	Create manual cost finops via the Qarion SDK.
create_meeting	Create a new DQ meeting.
create_organization	Create a new organization.
create_policy	Create a new governance policy.
create_product	Create a new data product in a space.
create_product_alert	Create an alert for a product.
create_quality_check	Create a new quality check.
create_recertification_cycle	Create a new recertification cycle.
create_risk_assessment	Create a new risk assessment for a product.
create_risk_entry	Create a new risk register entry.
create_screening	Create a new Art. 5 prohibited practices screening.
create_source_system	Create a source system.
create_source_system_credential	Create a source-system credential with secret output redacted.
create_source_system_role	Create a source-system access role.
create_team	Create a new team in a space.
create_ticket_alert	Create ticket alert via the Qarion SDK.
create_training_run_product	Create training run product via the Qarion SDK.
create_webhook	Create a new webhook.
create_workflow_definition	Create a new workflow definition.
credential_options	List credential options for a space.
delete_connector	Delete a connector.
delete_contract	Delete a data contract.
delete_credential	Delete a global credential.
delete_cycle_recertification_cycle	Delete cycle recertification cycle via the Qarion SDK.
delete_definition_workflow	Delete definition workflow via the Qarion SDK.
delete_domain	Delete domain via the Qarion SDK.
delete_glossary_term	Delete a glossary term.
delete_organization	Delete organization via the Qarion SDK.
delete_policy	Delete policy via the Qarion SDK.
delete_product_alert	Delete a product alert.
delete_source_system	Delete a source system.
delete_source_system_credential	Delete a source-system credential.
delete_source_system_role	Delete a source-system role.
delete_team	Delete a team.
delete_training_run_product	Delete training run product via the Qarion SDK.
delete_webhook	Delete webhook via the Qarion SDK.
detect_cost_anomalies	Manually trigger cost anomaly detection.
evaluate_all_policy	Evaluate all policy via the Qarion SDK.
evaluate_policy	Evaluate a policy against all products in the space.
event_contracts_compatibility	Call event contracts compatibility.
event_contracts_create	Call event contracts create.
event_contracts_create_version	Call event contracts create version.
event_contracts_export	Call event contracts export.
event_contracts_get	Call event contracts get.
event_contracts_iglu_schema	Call event contracts iglu schema.
event_contracts_latest	Call event contracts latest.
event_contracts_list	Call event contracts list.
event_contracts_list_versions	Call event contracts list versions.
event_contracts_publish	Call event contracts publish.
event_contracts_repository_sync	Call event contracts repository sync.
event_contracts_resolve_conflict	Call event contracts resolve conflict.
event_contracts_schema	Call event contracts schema.
event_contracts_update	Call event contracts update.
event_contracts_validate	Call event contracts validate.
event_contracts_version	Call event contracts version.
execute_workflow	Execute a workflow definition.
export_audit_log	Export audit log via the Qarion SDK.
export_csv_glossary_term	Export csv glossary term via the Qarion SDK.
generate_declaration_conformity_assessment	Generate declaration conformity assessment via the Qarion SDK.
get_approvers_domain	Get approvers domain via the Qarion SDK.
get_compliance_summary	Get compliance dashboard summary for a space.
get_conformity_assessment	Get details of a conformity assessment.
get_connector	Get details for a connector.
get_contract	Get a data contract by ID.
get_cross_space_dependencies	Get cross-space upstream/downstream dependencies for a product.
get_domain	Get details of a data domain.
get_domain_scorecard	Get governance health scorecard for a domain.
get_domain_tree	Get the hierarchy tree of data domains.
get_filter_suggestions_recertification_cycle	Get filter suggestions recertification cycle via the Qarion SDK.
get_finops_assets	Get paginated list of all data assets with cost/usage metrics.
get_finops_cost_trend	Get daily attributed vs unattributed cost trend.
get_finops_ledger	Get unified ledger entries for an organization.
get_finops_overview	Get org-wide FinOps KPI summary.
get_glossary_term	Get details of a glossary term.
get_incident	Get incident details.
get_incident_timeline	Get timeline events for an incident.
get_issue	Get a ticket by UUID.
get_issues_organization	Get issues organization via the Qarion SDK.
get_latest_refresh_product	Get latest refresh product via the Qarion SDK.
get_lineage_edges	Get lineage edges for a product.
get_lineage_impact	Run downstream impact analysis for a product.
get_lineage_product	Get lineage product via the Qarion SDK.
get_marketplace_featured	Get featured and trending marketplace listings.
get_marketplace_listing	Get details of a marketplace listing.
get_meeting	Get details of a meeting.
get_my_governance_roles	Get governance roles the current user holds in a space.
get_my_marketplace_listings	List marketplace listings published by the current user.
get_my_role	Get the current user's role in a space.
get_organization	Get details of an organization.
get_organization_products	List products across all spaces in an organization.
get_organization_stats	Get aggregated statistics for an organization.
get_page_url	Get the URL for a Qarion platform page.
get_policy	Get details of a governance policy.
get_product	Get detailed information about a data product.
get_product_by_id	Get detailed information about a data product by its UUID.
get_quality_check	Get a quality check by slug.
get_quality_check_by_id	Get a quality check by UUID.
get_quality_check_stats	Get aggregated statistics for a quality check.
get_quality_executions	Get execution history for a quality check.
get_quality_trends	Get daily quality trend aggregation for a data product.
get_ratings_marketplace_listing	Get ratings marketplace listing via the Qarion SDK.
get_recertification_cycle	Get a recertification cycle with all its audit items.
get_refresh_stats_product	Get refresh stats product via the Qarion SDK.
get_resource_history	Get audit history for a specific resource.
get_resource_permissions	Get all permissions the current user has on a resource.
get_risk_assessment	Get details of a risk assessment.
get_risk_entry	Get details of a risk register entry.
get_risk_heat_map	Get aggregated risk heat map data for a space.
get_screening	Get details of a prohibited practices screening.
get_source_system	Get source system details.
get_source_system_role	Get a source-system role.
get_space_cross_space_lineage_edges	Get space cross space lineage edges via the Qarion SDK.
get_team	Get a team by slug.
get_terms_for_product_glossary_term	Get terms for product glossary term via the Qarion SDK.
get_training_run_product	Get training run product via the Qarion SDK.
get_workflow_definition	Get a workflow definition by ID.
get_workflow_instance	Get a workflow instance by ID.
import_csv_glossary_term	Import csv glossary term via the Qarion SDK.
link_incident_ticket	Link an incident to a ticket.
link_product_glossary_term	Link product glossary term via the Qarion SDK.
link_products_risk_entry	Link products risk entry via the Qarion SDK.
list_alerts	List central alerts for a space.
list_audit_log	List audit log entries for a space.
list_by_product_contract	List by product contract via the Qarion SDK.
list_by_space_contract	List by space contract via the Qarion SDK.
list_categories_glossary_term	List categories glossary term via the Qarion SDK.
list_change_requests	List change requests for a data product.
list_conformity_assessments	List EU AI Act conformity assessments for a product.
list_connectors	List data connectors in a space.
list_contract_versions	List version history for a data contract.
list_contracts	List data contracts.
list_credentials	List global credentials with secrets redacted.
list_deliveries_webhook	List deliveries webhook via the Qarion SDK.
list_domains	List all data domains in an organization.
list_evaluations_policy	List evaluations policy via the Qarion SDK.
list_for_product_issue	List for product issue via the Qarion SDK.
list_form_instances	List form instances.
list_form_templates	List form templates.
list_glossary_terms	List business glossary terms in a space.
list_incidents	List incidents in a space.
list_issues	List tickets (issues) in a space.
list_manual_costs_finops	List manual costs finops via the Qarion SDK.
list_meetings	List DQ meetings for a space.
list_organizations	List organizations you have access to.
list_platform_pages	List available Qarion platform pages.
list_policies	List governance policies for a space.
list_product_alerts	List alerts for a product.
list_products	List data products in a space.
list_products_domain	List products domain via the Qarion SDK.
list_quality_checks	List all quality checks in a space.
list_quality_checks_for_product	List all quality checks linked to a specific data product.
list_recertification_cycles	List recertification cycles in a space.
list_refreshes_product	List refreshes product via the Qarion SDK.
list_risk_assessments	List risk assessments for a product.
list_risk_entries	List risk register entries for a space.
list_screenings	List Art. 5 prohibited practices screenings for a product.
list_source_system_credentials	List credentials for a source system with secret fields redacted.
list_source_systems	List source systems in a space.
list_space_members	List members of a space with their roles.
list_spaces	List all spaces the authenticated user has access to.
list_teams	List all teams in a space.
list_training_runs_product	List training runs product via the Qarion SDK.
list_webhooks	List all webhooks in a space.
list_workflow_definitions	List all workflow definitions.
log_training_run_product	Log training run product via the Qarion SDK.
marketplace_checklist	Evaluate the publishing checklist for a product.
model_repository_complete_artifact_upload	Complete a model artifact upload.
model_repository_create_model	Create a model repository model.
model_repository_delete_artifact	Delete a model artifact.
model_repository_download_artifact	Download a model artifact.
model_repository_initiate_artifact_upload	Initiate a model artifact upload.
model_repository_list_artifacts	List model artifacts.
model_repository_list_models	List model repository models.
model_repository_update_model	Update a model repository model.
model_repository_upload_artifact_chunk	Upload a model artifact chunk.
notebooks_archive_workspace	Archive a notebook workspace.
notebooks_create_file	Create a notebook repository file.
notebooks_create_link	Create a notebook link.
notebooks_create_session	Create a notebook kernel session.
notebooks_create_workspace	Create a notebook workspace.
notebooks_create_workspace_file	Create a notebook workspace file.
notebooks_delete_link	Delete a notebook link.
notebooks_delete_session	Delete a notebook kernel session.
notebooks_execute_session	Execute code in a notebook kernel session.
notebooks_get_file	Get a notebook repository file.
notebooks_get_workspace_file	Get a notebook workspace file.
notebooks_interrupt_session	Interrupt a notebook kernel session.
notebooks_list_files	List notebook repository files.
notebooks_list_kernel_profiles	List notebook kernel profiles.
notebooks_list_links	List notebook links.
notebooks_list_versions	List notebook versions.
notebooks_list_workspace_files	List notebook workspace files.
notebooks_list_workspaces	List notebook workspaces.
notebooks_restart_session	Restart a notebook kernel session.
notebooks_save_file	Save a notebook repository file.
notebooks_save_workspace_file	Save a notebook workspace file.
notebooks_update_workspace	Update a notebook workspace.
notify_incident_downstream	Notify downstream subscribers about an incident.
oci_repositories_archive_repository	Archive an OCI repository.
oci_repositories_create_project_scope	Create an OCI project scope.
oci_repositories_create_repository	Create an OCI repository.
oci_repositories_delete_reference	Delete an OCI artifact reference.
oci_repositories_get_project_scope_access	Get OCI project scope access.
oci_repositories_get_repository	Get an OCI repository.
oci_repositories_list_project_scopes	List OCI project scopes.
oci_repositories_list_repositories	List OCI repositories.
oci_repositories_update_project_scope	Update an OCI project scope.
oci_repositories_update_project_scope_access	Update OCI project scope access.
oci_repositories_update_repository	Update an OCI repository.
override_screening	Override screening via the Qarion SDK.
populate_recertification_cycle	Auto-populate audit items for a recertification cycle.
preview_impact_analysis	Preview downstream impact of changing a data product.
publish_form_template	Publish a form template.
publish_to_marketplace	Publish a data product to the marketplace.
push_integration_quality_result	Push a quality result through the integrations API.
push_quality_result	Push an externally computed quality check result.
python_packages_archive_repository	Archive a Python package repository.
python_packages_create_project_scope	Create a Python package project scope.
python_packages_create_repository	Create a Python package repository.
python_packages_delete_file	Delete a Python package file.
python_packages_download_file	Download a Python package file.
python_packages_get_file_scan	Get a Python package file scan.
python_packages_get_package	Get a package in a repository.
python_packages_get_project_scope_access	Get Python package project scope access.
python_packages_get_pypi_package_release	Get a public PyPI package release.
python_packages_get_pypi_package_versions	Get public PyPI package versions.
python_packages_get_repository	Get a Python package repository.
python_packages_get_scan_policy	Get a Python package scan policy.
python_packages_import_pypi_release	Import a public PyPI release.
python_packages_list_packages	List packages in a repository.
python_packages_list_project_scopes	List Python package project scopes.
python_packages_list_repositories	List Python package repositories.
python_packages_scan_file	Scan a Python package file.
python_packages_scan_repository	Scan a Python package repository.
python_packages_update_project_scope	Update a Python package project scope.
python_packages_update_project_scope_access	Update Python package project scope access.
python_packages_update_repository	Update a Python package repository.
python_packages_update_scan_policy	Update a Python package scan policy.
python_packages_upload_file	Upload a Python package file.
python_packages_yank_file	Yank or unyank a package file.
rate_marketplace_listing	Rate and optionally review a marketplace listing.
recertify_all_recertification_cycle	Recertify all recertification cycle via the Qarion SDK.
register_external_quality_check	Create an external quality check if needed and push a result.
register_integration_lineage	Register lineage between two products.
register_integration_refresh	Register a product refresh event.
register_model_product	Register model product via the Qarion SDK.
register_product_product	Register product product via the Qarion SDK.
register_prompt_product	Register prompt product via the Qarion SDK.
register_refresh_product	Register refresh product via the Qarion SDK.
reindex_documentation	Reindex documentation via the Qarion SDK.
remove_lineage_edge	Remove lineage edge via the Qarion SDK.
remove_space_organization	Remove space organization via the Qarion SDK.
remove_steward_domain	Remove steward domain via the Qarion SDK.
remove_team_member	Remove a user from a team.
remove_user_organization	Remove user organization via the Qarion SDK.
resolve_alert	Resolve an alert.
resolve_incident	Resolve an incident.
resolve_source_system_space	Resolve the owning space slug for a source system.
review_form_instance	Review a form instance.
review_recertification_audit	Approve or reject a recertification audit item.
run_quality_config	Run quality config via the Qarion SDK.
save_form_answers	Save answers for a form instance.
search	Search across all entity types within a space.
search_documentation	Search Qarion platform documentation.
search_organization	Search across all spaces in an organization.
set_lineage_product	Set lineage product via the Qarion SDK.
submit_conformity_assessment	Submit a conformity assessment for compliance review.
submit_form_instance	Submit a form instance.
submit_screening	Submit a screening for automated evaluation.
sync_connector	Trigger a metadata sync for a connector.
sync_integration_dbt_manifest	Sync a dbt manifest through an integration connector.
sync_integration_record_issues	Sync record-level issues from an external integration.
templates_risk_entry	Templates risk entry via the Qarion SDK.
test_webhook	Send a test event to a webhook.
transform_authoring_apply_chat_actions	Apply generated transform chat actions.
transform_authoring_apply_chat_message_actions	Apply actions from a chat message.
transform_authoring_archive_workspace	Archive a transform authoring workspace.
transform_authoring_chat	Send a transform authoring chat message.
transform_authoring_create_run	Create a transform authoring run.
transform_authoring_create_workspace	Create a transform authoring workspace.
transform_authoring_delete_file	Delete a transform draft file.
transform_authoring_discover_projects	Discover transform projects in a repository.
transform_authoring_draft_tree	Inspect a transform draft tree.
transform_authoring_list_chat_messages	List transform authoring chat messages.
transform_authoring_list_macros	List transform project macros.
transform_authoring_list_runs	List transform authoring runs.
transform_authoring_list_workspaces	List transform authoring workspaces.
transform_authoring_open_project	Open a transform project draft.
transform_authoring_preview_model	Preview a transform model.
transform_authoring_publish_project	Publish a transform authoring project.
transform_authoring_read_file	Read a transform draft file.
transform_authoring_rename_file	Rename a transform draft file.
transform_authoring_test_macro	Test a transform project macro.
transform_authoring_update_project	Update a transform authoring project.
transform_authoring_update_workspace	Update a transform authoring workspace.
transform_authoring_upsert_file	Create or update a transform draft file.
transform_authoring_validate_draft	Validate a transform draft.
transition_change_request	Transition a change request status (pending→under_review→approved→implemented).
trigger_quality_check	Trigger execution of a quality check.
unarchive_contract	Restore an archived data contract.
unarchive_cycle_recertification_cycle	Unarchive cycle recertification cycle via the Qarion SDK.
unassign_product_domain	Unassign product domain via the Qarion SDK.
unlink_product_glossary_term	Unlink product glossary term via the Qarion SDK.
unlink_product_risk_entry	Unlink product risk entry via the Qarion SDK.
unpublish_from_marketplace	Remove a listing from the marketplace.
update_config_recertification_cycle	Update config recertification cycle via the Qarion SDK.
update_conformity_assessment	Update conformity assessment via the Qarion SDK.
update_connector	Update connector metadata or configuration.
update_contract	Update a data contract.
update_credential	Update a global credential.
update_definition_workflow	Update definition workflow via the Qarion SDK.
update_domain	Update domain via the Qarion SDK.
update_form_template	Update a form template.
update_glossary_term	Update an existing glossary term.
update_incident	Update incident fields.
update_issue	Update an issue ticket.
update_meeting	Update meeting via the Qarion SDK.
update_member_role_team	Update member role team via the Qarion SDK.
update_mitigation_risk_assessment	Update mitigation risk assessment via the Qarion SDK.
update_organization	Update organization via the Qarion SDK.
update_policy	Update policy via the Qarion SDK.
update_product	Update a data product.
update_product_alert	Update a product alert.
update_quality_check	Update a quality check by slug.
update_risk_assessment	Update risk assessment via the Qarion SDK.
update_risk_entry	Update risk entry via the Qarion SDK.
update_screening	Update screening via the Qarion SDK.
update_severity_alert	Update severity alert via the Qarion SDK.
update_source_system	Update source system fields.
update_source_system_credential	Update a source-system credential with secret output redacted.
update_source_system_role	Update a source-system role.
update_team	Update team via the Qarion SDK.
update_training_run_product	Update training run product via the Qarion SDK.
update_user_role_organization	Update user role organization via the Qarion SDK.
update_webhook	Update webhook via the Qarion SDK.
upload_dbt_manifest_connector	Upload a dbt manifest file for connector sync.
validate_change_request	Validate change request via the Qarion SDK.
validate_file_contract	Validate file contract via the Qarion SDK.
validate_quality_config	Validate quality config via the Qarion SDK.
validate_records_contract	Validate records contract via the Qarion SDK.