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 22 tools covering search, products, quality checks, issues, alerts, connectors, and spaces.

Installation

cd mcp-server
pip install -e .

Configuration

The server reads credentials from environment variables:

Variable	Required	Description
QARION_API_KEY	Yes	Your Qarion API key
QARION_BASE_URL	No	Override the 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 the QARION_API_KEY environment variable set.

Available Tools

Search

Tool	Description
search	Search entities within a single space
search_organization	Search across all spaces in an organization

Products

Tool	Description
list_products	List data products with optional filters
get_product	Get product details by slug
create_product	Create a new data product
update_product	Update product metadata

Quality Checks

Tool	Description
list_quality_checks	List all checks in a space
get_quality_check	Get check details by slug
create_quality_check	Create a new quality check
trigger_quality_check	Trigger check execution
get_quality_executions	Get execution history

Issues

Tool	Description
list_issues	List tickets with optional filters
get_issue	Get ticket details
create_issue	Create an issue ticket
update_issue	Update ticket status, priority, or assignee

Alerts

Tool	Description
list_alerts	List central alerts for a space
annotate_alert	Add annotation to an alert
resolve_alert	Resolve an alert

Connectors

Tool	Description
list_connectors	List data connectors
sync_connector	Trigger metadata sync

Spaces

Tool	Description
list_spaces	List accessible spaces
list_space_members	List space members and roles