{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rau2dz2s9rj2","handle":"zephyr-squad-server-mcp","url":"https://wellknown.network/agents/zephyr-squad-server-mcp","links":{"self":"https://wellknown.network/agents/zephyr-squad-server-mcp/record.json","html":"https://wellknown.network/agents/zephyr-squad-server-mcp","markdown":"https://wellknown.network/agents/zephyr-squad-server-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zephyr-squad-server-mcp","status":"https://wellknown.network/api/v1/agents/zephyr-squad-server-mcp/status","claim":"https://wellknown.network/agents/zephyr-squad-server-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zephyr-squad-server-mcp/claim.json","badge":"https://wellknown.network/agents/zephyr-squad-server-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zephyr-squad-server-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zephyr-squad-server-mcp","summary":"MCP server for Zephyr Squad Server/Data Center — drive ZAPI test management from an AI agent.","description":"# zephyr-squad-server-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that lets an AI agent drive\n**Zephyr for Jira — Server / Data Center (ZAPI)**, the test-management suite for\nJira. It exposes the most common test-management operations (cycles, folders,\nexecutions, test steps, step results, ZQL search) as well-described tools over\n**stdio**, so it plugs into Claude Desktop, Claude Code, and any other MCP client.\n\n> This targets the **Server/DC** flavor (`/rest/zapi/latest`). It is **not** for\n> Zephyr Squad **Cloud**, which uses a different JWT-signed API.\n\n## Install\n\nThe server is published on PyPI and is easiest to run with\n[`uv`](https://docs.astral.sh/uv/):\n\n```bash\nuvx zephyr-squad-server-mcp        # run directly, no install\n# or\nuv tool install zephyr-squad-server-mcp\n# or, in a venv\npip install zephyr-squad-server-mcp\n```\n\n## Configuration\n\nThe connection rides on your Jira instance's authentication (shared by ZAPI and\nthe Jira core REST API). Configure via environment variables or a `.env` file\n(see [`.env.example`](.env.example)):\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `JIRA_URL` | ✅ | — | Jira base URL, e.g. `https://jira.company.com` (no `/rest` suffix). |\n| `JIRA_PERSONAL_TOKEN` | one of | — | Personal Access Token → `Authorization: Bearer …` (**recommended for DC**). |\n| `JIRA_USERNAME` + `JIRA_PASSWORD` | one of | — | Basic-auth fallback (password or API token). Used only if `JIRA_PERSONAL_TOKEN` is empty. |\n| `ZEPHYR_API_PATH` | | `/rest/zapi/latest` | ZAPI base path on the Jira host. |\n| `ZEPHYR_TIMEOUT` | | `30` | Per-request timeout (seconds). |\n| `ZEPHYR_VERIFY_SSL` | | `true` | Verify TLS certs. Set `false` only for trusted internal self-signed hosts. |\n\nThe server fails fast with a clear error if the base URL or authentication is\nmissing.\n\n## Client configuration (stdio)\n\nAdd to your MCP client config (e.g. Claude Desktop `claude_desktop_config.json`\nor Claude Code `.mcp.json`):\n\n```json\n{\n  \"mcpServers\"…","publisher":null,"homepage":"https://github.com/alejandroviera/zephyr-squad-server-mcp","repository":"https://github.com/alejandroviera/zephyr-squad-server-mcp","version":"1.1.1","license":"MIT","protocols":["mcp"],"tags":["jira","llm","mcp","test-management","zapi","zephyr"],"pricing":null,"endpoints":[{"url":"pypi:zephyr-squad-server-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"derived"},{"slug":"dev.project-management","name":"Project Management","confidence":1,"provenance":"declared"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"zephyr-squad-server-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:35.149Z","publishedAt":"2026-08-06T15:47:38.837035Z","latestVersion":"1.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zephyr-squad-server-mcp","url":"https://pypi.org/project/zephyr-squad-server-mcp/","firstSeenAt":"2026-09-10T16:23:51.118Z","fetchedAt":"2026-09-10T16:23:51.118Z","normalizedAt":"2026-09-10T16:23:51.118Z"}]},"firstSeenAt":"2026-09-10T16:23:51.118Z","updatedAt":"2026-09-10T16:24:35.149Z"}