{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dke9eueahbjd","handle":"isc-playbook-mcp-server","url":"https://wellknown.network/agents/isc-playbook-mcp-server","links":{"self":"https://wellknown.network/agents/isc-playbook-mcp-server/record.json","html":"https://wellknown.network/agents/isc-playbook-mcp-server","markdown":"https://wellknown.network/agents/isc-playbook-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/isc-playbook-mcp-server","status":"https://wellknown.network/api/v1/agents/isc-playbook-mcp-server/status","claim":"https://wellknown.network/agents/isc-playbook-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/isc-playbook-mcp-server/claim.json","badge":"https://wellknown.network/agents/isc-playbook-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/isc-playbook-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/isc-playbook-mcp-server/tools"},"ard":{"identifier":"urn:air::server:isc-playbook-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"isc-playbook-mcp-server","summary":"MCP server for searching and browsing the IBM ISC Playbook with hybrid search capabilities","description":"# ISC Playbook MCP Server\n\nModel Context Protocol (MCP) server for searching and browsing the IBM ISC Playbook with hybrid search capabilities.\n\n## Features\n\n- **Hybrid Search**: Combines semantic (dense vectors) and keyword (sparse vectors) search using Milvus Lite\n- **1,358 Indexed Pages**: Complete IBM ISC Playbook content (1,091 documents + 266 folders)\n- **Natural Language Queries**: Search using conversational questions\n- **GitHub Copilot Integration**: Access playbook directly from VS Code\n\n## Architecture\n\n- **Vector Database**: Milvus Lite (embedded, no external service needed)\n- **Embeddings**: sentence-transformers (all-MiniLM-L6-v2, 384-dim)\n- **Search Algorithm**: RRF (Reciprocal Rank Fusion) for result merging\n- **MCP Framework**: FastMCP (Python SDK)\n\n## Installation\n\n### Option 1: Using uvx (Recommended)\n\nThe easiest way to use this MCP server is with `uvx`:\n\n```bash\n# Install and run directly with uvx\nuvx isc-playbook-mcp-server\n```\n\n### Option 2: From PyPI\n\n```bash\n# Install from PyPI\npip install isc-playbook-mcp-server\n\n# Run the server\nisc-playbook-mcp-server\n```\n\n### Option 3: From Source (Development)\n\n1. **Clone the repository**:\n\n   ```bash\n   git clone git@github.ibm.com:kirtijha/isc-playbook-mcp-server.git\n   cd isc-playbook-mcp-server\n   ```\n\n2. **Install with uv**:\n\n   ```bash\n   uv pip install -e .\n   ```\n\n   Or with pip:\n\n   ```bash\n   python -m venv .venv\n   source .venv/bin/activate  # On macOS/Linux\n   pip install -e .\n   ```\n\n## Usage\n\n### MCP Server Configuration\n\nAdd to your MCP settings file (e.g., `~/.config/mcp/mcp.json` or VS Code's MCP settings):\n\n#### Using uvx (Recommended):\n\n```json\n{\n  \"mcpServers\": {\n    \"isc-playbook\": {\n      \"command\": \"uvx\",\n      \"args\": [\"isc-playbook-mcp-server\"]\n    }\n  }\n}\n```\n\n#### Using installed package:\n\n```json\n{\n  \"mcpServers\": {\n    \"isc-playbook\": {\n      \"command\": \"isc-playbook-mcp-server\"\n    }\n  }\n}\n}\n```\n\n### Available Tools\n\n1. **search_playbook**: Natural language search across a…","publisher":null,"homepage":"https://github.com/yourusername/isc-playbook-mcp-server","repository":"https://github.com/yourusername/isc-playbook-mcp-server","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["hybrid-search","mcp","milvus","playbook","search"],"pricing":null,"endpoints":[{"url":"pypi:isc-playbook-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":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.825,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["data","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":"isc-playbook-mcp-server","registry":"pypi","observedAt":"2026-09-15T21:22:07.137Z","publishedAt":"2025-11-13T04:53:01.106939Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"isc-playbook-mcp-server","url":"https://pypi.org/project/isc-playbook-mcp-server/","firstSeenAt":"2026-09-09T22:22:04.046Z","fetchedAt":"2026-09-15T21:20:25.120Z","normalizedAt":"2026-09-15T21:20:25.120Z"}]},"firstSeenAt":"2026-09-09T22:22:04.046Z","updatedAt":"2026-09-15T21:22:07.137Z"}