{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3ymamq5y8jd3","handle":"win-mcp-server","url":"https://wellknown.network/agents/win-mcp-server","links":{"self":"https://wellknown.network/agents/win-mcp-server/record.json","html":"https://wellknown.network/agents/win-mcp-server","markdown":"https://wellknown.network/agents/win-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/win-mcp-server","status":"https://wellknown.network/api/v1/agents/win-mcp-server/status","claim":"https://wellknown.network/agents/win-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/win-mcp-server/claim.json","badge":"https://wellknown.network/agents/win-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:win-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"win-mcp-server","summary":"MCP server for Windows Remote Management (WinRM) with secure domain authentication","description":"# Win MCP Server\n\nA Model Context Protocol (MCP) server that provides AI agents with the ability to interact with Windows servers using Windows Remote Management (WinRM). This server enables secure remote PowerShell execution and system management tasks on Windows hosts.\n\n## Features\n\n- **Secure Authentication**: Uses domain credentials stored in macOS Keychain with TouchID authentication\n- **PowerShell Execution**: Execute arbitrary PowerShell commands on remote Windows hosts\n- **System Information**: Get basic system information, running services, and disk space\n- **Error Handling**: Comprehensive error handling with helpful error messages\n- **Memory Safety**: Credentials are cleared from memory immediately after use\n\n## Installation\n\n### From PyPI (Recommended)\n\n```bash\npip install win-mcp-server\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/rorymcmahon/win-mcp-server.git\ncd win-mcp-server\npip install -e .\n```\n\n## Configuration\n\n### Prerequisites\n\n1. **WinRM Configuration**: Ensure target Windows hosts have WinRM enabled and configured.\n\n2. **Credential Setup**: The server will prompt for credentials on first use and cache them securely in macOS Keychain with 4-hour expiration.\n\n### MCP Configuration\n\nAdd to your MCP settings file (e.g., `~/.config/mcp/settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"winrm\": {\n      \"command\": \"winrm-mcp-server\"\n    }\n  }\n}\n```\n\n## Available Tools\n\n### `setup_credentials(hostname: str)`\nSetup credentials for a Windows host (interactive mode).\n\n**Parameters:**\n- `hostname`: The target Windows hostname (FQDN)\n\n**Returns:**\n- `status`: Success or error status\n- `message`: Confirmation message\n\n### `execute_powershell(hostname: str, command: str)`\nExecute arbitrary PowerShell commands on a remote Windows host.\n\n**Parameters:**\n- `hostname`: The target Windows hostname (FQDN)\n- `command`: PowerShell command to execute\n\n**Returns:**\n- `status`: Exit code of the command\n- `stdout`: Standard output from the command\n- `std…","publisher":null,"homepage":"https://github.com/rorymcmahon/win-mcp-server#readme","repository":"https://github.com/rorymcmahon/win-mcp-server#readme","version":"0.2.3","license":"MIT","protocols":["mcp"],"tags":["mcp","winrm","windows","remote","management","powershell"],"pricing":null,"endpoints":[{"url":"pypi:win-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":"security.secrets","name":"Secrets Management","confidence":0.859,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"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":"win-mcp-server","registry":"pypi","observedAt":"2026-09-10T15:25:33.854Z","publishedAt":"2025-09-25T09:07:34.183926Z","latestVersion":"0.2.3"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"win-mcp-server","url":"https://pypi.org/project/win-mcp-server/","firstSeenAt":"2026-09-10T15:24:52.477Z","fetchedAt":"2026-09-10T15:24:52.477Z","normalizedAt":"2026-09-10T15:24:52.477Z"}]},"firstSeenAt":"2026-09-10T15:24:52.477Z","updatedAt":"2026-09-10T15:25:33.854Z"}