What can you do with this server?

This MCP server provides an interface to the openQA REST API, enabling both read-only querying and mutating operations (the latter requiring API credentials). Read Operations (no credentials required): * List and filter jobs by state, result, distribution, version, build, etc.; get job overviews and full details * Get lightweight job status (id, state, result, blocked_by_id) or full test-module/step breakdown * Find jobs by a specific setting key-value pair * List comments on jobs, job groups, and parent job groups * List configured machines, test suites, products, job groups, parent groups, assets, workers, and tracked bugs * Get aggregated build results for a job group * Get scheduled product details and ISO job statistics * Full-text search across jobs, groups, and test modules * Check current identity (whoami) Mutating Operations (require API credentials): * Restart, cancel, duplicate, delete, or set priority on jobs; bulk-restart or cancel-all-matching jobs * Add, update, or delete comments on jobs, job groups, and parent job groups * Trigger ISO test scheduling for a product; cancel a scheduled product * Create tracked bug references Configuration & Deployment: * Configurable via environment variables (OPENQA_SERVER, OPENQA_API_KEY, OPENQA_API_SECRET, OPENQA_VERIFY) or ~/.config/openqa/client.conf * Run in read-only mode (--readonly / OPENQA_READONLY=true) to disable all mutating tools * Supports stdio transport (default, for local clients) or HTTP transport (--http) for remote/shared deployments

Which integrations are available for this server?

Provides tools to interact with the openQA REST API, enabling management of jobs, comments, machines, test suites, and products for automated testing.

How do I use openqa-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@openqa-mcp list recent openQA jobs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

openqa-mcp

by mimi1vx

Overview Schema Related Servers Score Discussions

Python

Hybrid

openqa-mcp

An MCP server that exposes curated, typed tools over the openQA REST API. It is built on fastmcp 3.x and the openqa-async transport client.

Read tools work anonymously; mutating tools require API credentials and return 403 without them.

Install

uv sync

This installs the package and its dependencies into a project virtualenv and exposes the openqa-mcp console script.

Related MCP server: MCP REST Server

Configuration

The server reads its configuration from environment variables, falling back to the openQA client config file for credentials.

Environment variables

Variable	Default	Purpose
`OPENQA_SERVER`	openqa-async default	openQA host (e.g. `openqa.opensuse.org`).
`OPENQA_API_KEY`	(unset)	API key; overrides the config file when set.
`OPENQA_API_SECRET`	(unset)	API secret; overrides the config file when set.
`OPENQA_VERIFY`	`true`	TLS verification: `true`/`false`, or a path to a CA bundle.

OPENQA_API_KEY and OPENQA_API_SECRET only take effect when both are set; a partial pair is ignored so the client is never half-configured.

Config file

If the env credentials are not set, openqa-async loads them from ~/.config/openqa/client.conf (or /etc/openqa/client.conf). Generate a key/secret from the API keys page of your openQA instance and add a section keyed by the host:

[openqa.opensuse.org]
key = YOUR_API_KEY
secret = YOUR_API_SECRET

Without any credentials the server is GET-only (read tools succeed, mutating tools get 403).

Tools

Read tools

Tool	Description
`list_jobs`	List jobs matching the given filters.
`list_jobs_overview`	List a condensed jobs overview matching the given filters.
`get_job`	Get full details for a single job.
`get_job_comments`	List comments on a job.
`list_machines`	List configured worker machines.
`list_test_suites`	List configured test suites.
`list_products`	List configured products (mediums).
`find_jobs_by_setting`	Find jobs whose setting `key` equals `list_value`.
`get_job_details`	Get a single job with full test-module/step details.
`get_job_status`	Get a lightweight job status (id, state, result, blocked_by_id).
`list_job_groups`	List job groups.
`get_job_group`	Get a single job group.
`list_job_group_jobs`	List jobs belonging to a job group.
`get_job_group_build_results`	Get aggregated build results for a job group.
`list_parent_groups`	List parent job groups.
`get_parent_group`	Get a single parent job group.
`list_assets`	List assets known to the system.
`get_asset`	Get a single asset by id.
`list_workers`	List registered worker instances.
`list_bugs`	List tracked bugs referenced by jobs.
`search`	Full-text search across jobs, groups, and test modules.
`get_scheduled_product`	Get a scheduled product (result of a prior ISO trigger).
`get_iso_job_stats`	Get job statistics for scheduled products.
`list_group_comments`	List comments on a job group.
`list_parent_group_comments`	List comments on a parent job group.

list_jobs and list_jobs_overview accept the same optional filters: state, result, distri, version, build, test, arch, machine, groupid, group, latest, limit, page, ids. Unset filters are dropped from the request.

Mutating tools (require credentials)

Tool	Description
`restart_jobs`	Restart each of the given jobs.
`cancel_job`	Cancel a running or scheduled job.
`add_job_comment`	Add a comment to a job.
`trigger_isos`	Trigger ISO test scheduling for a product.
`delete_job`	Delete a job.
`duplicate_job`	Duplicate (clone) a job.
`set_job_priority`	Set the priority of a job.
`restart_jobs_bulk`	Restart several jobs in one bulk request.
`cancel_jobs`	Cancel all jobs matching the given filters.
`add_group_comment`	Add a comment to a job group.
`add_parent_group_comment`	Add a comment to a parent job group.
`update_job_comment`	Update an existing job comment.
`delete_job_comment`	Delete a job comment.
`create_bug`	Create a tracked bug reference.
`cancel_scheduled_product`	Cancel a scheduled product / ISO by name.

Mutating tools carry the mutating tag so MCP clients can gate them behind confirmation. To drop them entirely, start the server in read-only mode with --readonly (or OPENQA_READONLY=true): the mutating tools are never registered, so clients see only the read tools.

Running

stdio (default)

Most local MCP clients spawn the server over stdio. Wire it in with:

uv run openqa-mcp

Example MCP client configuration:

{
  "mcpServers": {
    "openqa": {
      "command": "uv",
      "args": ["run", "openqa-mcp"],
      "env": {
        "OPENQA_SERVER": "openqa.opensuse.org"
      }
    }
  }
}

HTTP (optional)

For remote or shared deployments, run over HTTP with --http:

uv run openqa-mcp --http --server 127.0.0.1 --port 8000

The server can also be launched as a module:

uv run python -m openqa_mcp --http --port 8000

Flag	Default	Purpose
`--http`	off	Serve over HTTP instead of stdio.
`--stdio`	on	Serve over stdio; overrides `OPENQA_MCP_TRANSPORT=http`.
`--server`	`127.0.0.1`	HTTP bind host.
`--port`	`8000`	HTTP bind port.
`--readonly`	off	Unregister all mutating tools (read-only server).

Flags override the environment, which supplies the defaults:

Variable	Default	Purpose
`OPENQA_MCP_TRANSPORT`	`stdio`	Set to `http` to serve over HTTP.
`OPENQA_MCP_HOST`	`127.0.0.1`	Default HTTP bind host.
`OPENQA_MCP_PORT`	`8000`	Default HTTP bind port.
`OPENQA_READONLY`	`false`	Set truthy (`1`/`true`/`yes`/`on`) to disable mutating tools.

Press Ctrl-C to stop; the server shuts down cleanly and closes its client.

Development

uv run pytest        # run the test suite
uv run ruff check .  # lint

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

3Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mimi1vx/openqa-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server