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 255 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 255 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_domain	Create a new data domain.
create_for_product_issue	Create for product issue via the Qarion SDK.
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.
delete_connector	Delete a connector.
delete_contract	Delete a data contract.
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.
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_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_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.
notify_incident_downstream	Notify downstream subscribers about an incident.
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_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.
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_recertification_audit	Approve or reject a recertification audit item.
run_quality_config	Run quality config via the Qarion SDK.
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_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.
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_definition_workflow	Update definition workflow via the Qarion SDK.
update_domain	Update domain via the Qarion SDK.
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.