{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_j9yjcmufdwhw","handle":"quads-mcp","url":"https://wellknown.network/agents/quads-mcp","links":{"self":"https://wellknown.network/agents/quads-mcp/record.json","html":"https://wellknown.network/agents/quads-mcp","markdown":"https://wellknown.network/agents/quads-mcp/record.md","api":"https://wellknown.network/api/v1/agents/quads-mcp","status":"https://wellknown.network/api/v1/agents/quads-mcp/status","claim":"https://wellknown.network/agents/quads-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/quads-mcp/claim.json","badge":"https://wellknown.network/agents/quads-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/quads-mcp/history","tools":"https://wellknown.network/api/v1/agents/quads-mcp/tools"},"ard":{"identifier":"urn:air::server:quads-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"quads-mcp","summary":"A Model Context Protocol server for QUADS bare-metal server management","description":"# quads-mcp\n\nA Model Context Protocol for QUADS\n\n## Overview\n\nThis is a Model Context Protocol (MCP) server that exposes tools, resources, and prompts for use with LLM applications like Claude. MCP servers let you extend AI applications with custom functionality, data sources, and templated interactions.\n\n## Quick Start\n\n### Option 1: Run with uvx (Easiest)\n\nThe fastest way to run the server without any setup:\n\n```bash\n# Install uv if you don't have it\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Run the server directly (from project directory)\nuvx --from . quads-mcp\n\n# Or run the module\nuvx --from . python -m quads_mcp.server\n```\n\n### Option 2: Setup with uv (Recommended)\n\n```bash\n# Set up the environment\nmake setup\n\n# Check virtual environment status\nmake status\n\n# Run the server (automatically uses virtual environment)\nmake run\n\n# Run in development mode with MCP Inspector\nmake dev\n\n# Install the server in Claude Desktop\nmake install\n```\n\n**Note**: You don't need to manually activate the virtual environment when using `make` commands - they automatically use the `.venv` environment!\n\nIf you encounter import errors, run `make reinstall` to refresh the package installation.\n\n### Option 3: Manual Setup\n\n```bash\n# Install uv if you don't have it\npip install uv\n\n# Create a virtual environment\nuv venv\n\n# Activate the virtual environment\nsource .venv/bin/activate  # On Unix/MacOS\n# or\n.venv\\Scripts\\activate     # On Windows\n\n# Install the package in development mode\nuv pip install -e .\n\n# Run in development mode\nmcp dev quads_mcp.server\n\n# Install in Claude Desktop\nmcp install quads_mcp.server\n```\n\n### uvx Configuration\n\nWhen running with uvx, you can configure the server using environment variables or .env files:\n\n```bash\n# Option 1: Environment variables\nMCP_QUADS__BASE_URL=\"https://your-quads-api.com/api/v3\" \\\nMCP_QUADS__AUTH_TOKEN=\"your-token\" \\\nuvx --from . quads-mcp\n\n# Option 2: .env file (recommended)\ncp .env.example .env\n# Edit .env with your configuratio…","publisher":null,"homepage":"https://github.com/grafuls/quads-mcp/blob/main/README.md","repository":"https://github.com/grafuls/quads-mcp/issues","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","quads","server","management","bare-metal","claude"],"pricing":null,"endpoints":[{"url":"pypi:quads-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":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["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":"quads-mcp","registry":"pypi","observedAt":"2026-11-03T23:22:45.731Z","publishedAt":"2025-07-10T10:25:12.328135Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"quads-mcp","url":"https://pypi.org/project/quads-mcp/","firstSeenAt":"2026-09-10T10:25:08.452Z","fetchedAt":"2026-11-03T23:20:42.386Z","normalizedAt":"2026-11-03T23:20:42.386Z"}]},"firstSeenAt":"2026-09-10T10:25:08.452Z","updatedAt":"2026-11-03T23:22:45.731Z"}