{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zs2fb3bax8xr","handle":"semaphore-mcp-server","url":"https://wellknown.network/agents/semaphore-mcp-server","links":{"self":"https://wellknown.network/agents/semaphore-mcp-server/record.json","html":"https://wellknown.network/agents/semaphore-mcp-server","markdown":"https://wellknown.network/agents/semaphore-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/semaphore-mcp-server","status":"https://wellknown.network/api/v1/agents/semaphore-mcp-server/status","claim":"https://wellknown.network/agents/semaphore-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/semaphore-mcp-server/claim.json","badge":"https://wellknown.network/agents/semaphore-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/semaphore-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/semaphore-mcp-server/tools"},"ard":{"identifier":"urn:air::server:semaphore-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"semaphore-mcp-server","summary":"A comprehensive MCP server for Semaphore UI integration","description":"# Semaphore MCP Server\n\n![Semaphore MCP Server](semaphore-mcp-server.svg?raw=true)\n\nA Model Context Protocol (MCP) server for [Semaphore UI](https://semaphoreui.com/) - the modern open-source alternative to Ansible Tower/AWX.\n\nThis server enables AI assistants and MCP-compatible tools to interact with Semaphore UI for managing Ansible, Terraform, and other automation workflows.\n\n## Features\n\n- **Project Management** — List, create, and delete projects\n- **Task Management** — Launch, monitor, stop, and retrieve output of tasks\n- **Template Management** — CRUD operations on job templates\n- **Inventory Management** — Manage Ansible inventories\n- **Repository Management** — Manage Git repositories\n- **Environment Management** — Manage environment variable sets\n- **Key Store** — List and manage SSH keys and credentials\n- **Schedule Management** — Create and manage cron-based schedules\n- **User & Events** — Get user info and project event logs\n- **Server Info** — Check server health and version\n\n## Installation\n\n```bash\npip install -e .\n```\n\nOr with the semaphore client from a local path:\n\n```bash\npip install -e /path/to/python3-semaphore-client\npip install -e .\n```\n\n## Configuration\n\nCopy `.env.example` to `.env` and configure:\n\n```bash\ncp .env.example .env\n```\n\nRequired environment variables:\n\n| Variable | Description |\n|----------|-------------|\n| `SEMAPHORE_URL` | Base URL of your Semaphore UI instance (e.g., `http://localhost:3000`) |\n| `SEMAPHORE_TOKEN` | API Bearer token (create via Semaphore UI or API) |\n\nOptional environment variables:\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `READ_ONLY` | `true` | Set to `false` to enable write operations |\n| `DEBUG` | _(unset)_ | Set to `true` for verbose logging |\n\n### Creating an API Token\n\n1. **Via Web UI** (Semaphore 2.14+): Go to your user settings and create a token\n2. **Via API**:\n   ```bash\n   # Login\n   curl -c /tmp/semaphore-cookie -XPOST \\\n     -H 'Content-Type: application/json' …","publisher":null,"homepage":"https://github.com/VitexSoftware/semaphore-mcp-server","repository":"https://github.com/VitexSoftware/semaphore-mcp-server","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["semaphore","mcp","ansible","automation","api","server"],"pricing":null,"endpoints":[{"url":"pypi:semaphore-mcp-server","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":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.802,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"}],"categories":["commerce","dev"],"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":"semaphore-mcp-server","registry":"pypi","observedAt":"2026-11-04T00:27:28.913Z","publishedAt":"2026-05-03T21:53:31.415328Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"semaphore-mcp-server","url":"https://pypi.org/project/semaphore-mcp-server/","firstSeenAt":"2026-09-10T12:21:28.483Z","fetchedAt":"2026-11-04T00:26:09.208Z","normalizedAt":"2026-11-04T00:26:09.208Z"}]},"firstSeenAt":"2026-09-10T12:21:28.483Z","updatedAt":"2026-11-04T00:27:28.913Z"}