{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yedjghe9e6y5","handle":"iflow-mcp-sbarbett-pihole-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-sbarbett-pihole-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-sbarbett-pihole-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-sbarbett-pihole-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-sbarbett-pihole-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-sbarbett-pihole-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-sbarbett-pihole-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_sbarbett-pihole-mcp-server","summary":"A Model Context Protocol server for Pi-hole","description":"# 🍓 pihole-mcp-serer\n\nA Model Context Protocol (MCP) server for Pi-hole. This server exposes Pi-hole functionality as tools that can be used by AI assistants.\n\n## Dependencies\n\n### Docker\n\n- [Docker install guide](https://docs.docker.com/engine/install/)\n\n### `uv` (Optional, for Development)\n\nIf you want to run the application locally, use `uv`. Install it with your package manager of choice.\n\n## Environment\n\nCreate a `.env` file in the project root with your Pi-hole credentials:\n\n```\n# Primary Pi-hole (required)\nPIHOLE_URL=https://your-pihole.local/\nPIHOLE_PASSWORD=your-admin-password\n#PIHOLE_NAME=Primary        # optional, defaults to URL if unset\n\n# Secondary Pi-hole (optional)\n#PIHOLE2_URL=https://secondary-pihole.local/\n#PIHOLE2_PASSWORD=password2\n#PIHOLE2_NAME=Secondary     # optional\n\n# Up to 4 Pi-holes:\n#PIHOLE3_URL=...\n#PIHOLE3_PASSWORD=...\n#PIHOLE3_NAME=...\n\n#PIHOLE4_URL=...\n#PIHOLE4_PASSWORD=...\n#PIHOLE4_NAME=...\n```\n\n## Project Structure\n\nThe project follows a modular organization for better maintainability:\n\n```\n/\n├── main.py                # Main application entry point\n├── tools/                 # Pi-hole tools organized by functionality\n│   ├── __init__.py\n│   ├── config.py          # Configuration-related tools (DNS settings)\n│   └── metrics.py         # Metrics and query-related tools\n├── resources/             # MCP resources\n│   ├── __init__.py\n│   └── common.py          # Common resources (piholes://, version://)\n├── docker-compose.yml     # Docker Compose configuration for production\n├── docker-compose.dev.yml # Docker Compose for development with volume mounts\n└── Dockerfile             # Docker build configuration\n```\n\nThis structure separates the code into logical components while maintaining compatibility with all run modes.\n\n## Running the Server\n\nThere are several ways to run the Pi-hole MCP server:\n\n### Using Docker (Recommended for Production)\n\n```bash\n# Standard deployment\ndocker-compose up -d\n```\n\nThe server will be available at `ht…","publisher":null,"homepage":null,"repository":null,"version":"0.2.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_sbarbett-pihole-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"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":"iflow-mcp_sbarbett-pihole-mcp-server","registry":"pypi","observedAt":"2026-09-15T20:21:18.101Z","publishedAt":"2026-02-04T09:59:46.552494Z","latestVersion":"0.2.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_sbarbett-pihole-mcp-server","url":"https://pypi.org/project/iflow-mcp_sbarbett-pihole-mcp-server/","firstSeenAt":"2026-09-09T21:23:38.076Z","fetchedAt":"2026-09-15T20:19:20.446Z","normalizedAt":"2026-09-15T20:19:20.446Z"}]},"firstSeenAt":"2026-09-09T21:23:38.076Z","updatedAt":"2026-09-15T20:21:18.101Z"}