{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wzdmwznddd8y","handle":"semantic-mcp","url":"https://wellknown.network/agents/semantic-mcp","links":{"self":"https://wellknown.network/agents/semantic-mcp/record.json","html":"https://wellknown.network/agents/semantic-mcp","markdown":"https://wellknown.network/agents/semantic-mcp/record.md","api":"https://wellknown.network/api/v1/agents/semantic-mcp","status":"https://wellknown.network/api/v1/agents/semantic-mcp/status","claim":"https://wellknown.network/agents/semantic-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/semantic-mcp/claim.json","badge":"https://wellknown.network/agents/semantic-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:semantic-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"semantic-mcp","summary":"Semantic router for MCP ecosystems - Discover, manage, and execute tools across multiple MCP servers with progressive disclosure","description":"# Semantic MCP\n\n[![PyPI version](https://badge.fury.io/py/semantic-mcp.svg)](https://pypi.org/project/semantic-mcp/)\n[![Docker](https://img.shields.io/docker/v/milkymap/semantic-mcp?label=docker)](https://hub.docker.com/r/milkymap/semantic-mcp)\n\nSemantic router for MCP ecosystems - Discover, manage, and execute tools across multiple MCP servers with progressive disclosure.\n\n## Overview\n\n`semantic-mcp` is a FastMCP-based MCP server that provides semantic discovery and lifecycle management for other MCP servers. It connects to a discovery service for semantic search and manages server lifecycles locally via ZMQ-based IPC.\n\n```\nLLM Client (Claude/Cline)\n    │ MCP Protocol\n    ▼\n┌─────────────────────────────┐\n│       semantic-mcp          │\n│    (FastMCP MCP Server)     │\n├─────────────────────────────┤\n│  Discovery → Semantic API   │\n│  Execution → ZMQ + Sessions │\n└─────────────────────────────┘\n    │               │\n    ▼               ▼\nDiscovery       MCP Servers\nService         (stdio/http)\n```\n\n## Installation\n\n### Option 1: uvx (Recommended)\n\n```bash\nuvx semantic-mcp serve --transport stdio\n```\n\n### Option 2: pip/uv\n\n```bash\n# Install from PyPI\npip install semantic-mcp\n\n# Or with uv\nuv pip install semantic-mcp\n\n# Run\nsemantic-mcp serve --transport stdio\n```\n\n### Option 3: Docker\n\n```bash\ndocker pull milkymap/semantic-mcp:0.2\n\ndocker run -d \\\n  -p 8001:8001 \\\n  -e DISCOVERY_URL=http://your-discovery-service \\\n  -e DISCOVERY_API_KEY=your-key \\\n  milkymap/semantic-mcp:0.2 serve --transport streamable-http --port 8001\n```\n\n### Option 4: From source\n\n```bash\ngit clone https://github.com/milkymap/mcp_runtime\ncd mcp_runtime\nuv sync\nuv run semantic-mcp serve\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `DISCOVERY_URL` | Discovery service API URL | `http://localhost:8000` |\n| `DISCOVERY_API_KEY` | API key for discovery authentication | None |\n| `DISCOVERY_ENCRYPTION_KEY` | Key to decrypt s…","publisher":{"name":"BA Ibrahima","url":null},"homepage":"https://github.com/milkymap/semantic-mcp","repository":"https://github.com/milkymap/semantic-mcp","version":"0.2.1","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","semantic-search","llm","ai-agents","tool-routing","semantic-mcp"],"pricing":null,"endpoints":[{"url":"pypi:semantic-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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"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":"semantic-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:18.661Z","publishedAt":"2026-01-29T13:57:00.648287Z","latestVersion":"0.2.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"semantic-mcp","url":"https://pypi.org/project/semantic-mcp/","firstSeenAt":"2026-09-10T12:21:27.019Z","fetchedAt":"2026-09-10T12:21:27.019Z","normalizedAt":"2026-09-10T12:21:27.019Z"}]},"firstSeenAt":"2026-09-10T12:21:27.019Z","updatedAt":"2026-09-10T12:23:18.661Z"}