{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5ufuq44jctqd","handle":"hotkv-mcp","url":"https://wellknown.network/agents/hotkv-mcp","links":{"self":"https://wellknown.network/agents/hotkv-mcp/record.json","html":"https://wellknown.network/agents/hotkv-mcp","markdown":"https://wellknown.network/agents/hotkv-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hotkv-mcp","status":"https://wellknown.network/api/v1/agents/hotkv-mcp/status","claim":"https://wellknown.network/agents/hotkv-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hotkv-mcp/claim.json","badge":"https://wellknown.network/agents/hotkv-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hotkv-mcp/history","tools":"https://wellknown.network/api/v1/agents/hotkv-mcp/tools"},"ard":{"identifier":"urn:air::server:hotkv-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hotkv-mcp","summary":"A Model Context Protocol (MCP) server for HotKV, a RESP2/RESP3-compatible in-memory data store with built-in AI and LLM-serving features. Lets AI agents read and write keys, agent memory, prompts and RAG documents.","description":"# HotKV MCP Server\n\n[![CI](https://github.com/hotkv-ltd/hotkv-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/hotkv-ltd/hotkv-mcp/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for [HotKV](https://hotkv.com),\na RESP2/RESP3-compatible in-memory data store with built-in AI and LLM-serving features (semantic\nand prompt caching, agent memory, RAG, feature store, rate limiting, time series and more).\nIt lets an AI assistant or agent (Claude, Cursor, VS Code, your own) read and write keys, keep\nconversation memory and notes, log events, store prompt templates and search documents in a\nHotKV server.\n\n- A fixed set of 28 tools. There is no tool that runs an arbitrary command, so an agent cannot\n  flush a database, change the server's configuration or read the keys of other tenants.\n- `--read-only` removes every write tool, so the agent cannot even see them.\n- `--namespace` confines the agent to one prefix: it can only use and list names under it.\n- Results are capped (`--max-value-bytes`, `--max-items`), and a cut value is flagged\n  `truncated`, so a huge value cannot flood the model's context.\n- stdio for local clients, streamable HTTP for shared use.\n\nWritten against HotKV server 0.3.0 and the official `hotkv-client` Python package.\n\n## Install\n\n```bash\npip install hotkv-mcp\n```\n\nor run it without installing, with [uv](https://docs.astral.sh/uv/):\n\n```bash\nuvx hotkv-mcp --url hotkv://localhost:6379\n```\n\nPython 3.10 or newer.\n\n## Connect a client\n\nThe server speaks stdio by default, so a client launches it as a subprocess.\n\n**Claude Code**\n\n```bash\nclaude mcp add hotkv -- uvx hotkv-mcp --url hotkv://localhost:6379\n```\n\n**Claude Desktop, Cursor and other clients that read an `mcpServers` file**\n\n```json\n{\n  \"mcpServers\": {\n    \"hotkv\": {\n      \"command\": \"uvx\",\n      \"args\": [\"hotkv-mcp\", \"--read-only\"],\n      \"env\": { \"HOTKV_URL\": \"h…","publisher":null,"homepage":"https://docs.hotkv.com","repository":"https://github.com/hotkv-ltd/hotkv-mcp/issues","version":"1.0.0","license":null,"protocols":["mcp"],"tags":["hotkv","mcp","model-context-protocol","ai","agents","llm","key-value","memory"],"pricing":null,"endpoints":[{"url":"pypi:hotkv-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"knowledge.memory","name":"Agent Memory","confidence":1,"provenance":"declared"},{"slug":"ai.prompting","name":"Prompt Management","confidence":0.871,"provenance":"derived"}],"categories":["ai","knowledge"],"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":"hotkv-mcp","registry":"pypi","observedAt":"2026-10-24T17:29:04.974Z","publishedAt":"2026-10-11T08:17:34.300168Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hotkv-mcp","url":"https://pypi.org/project/hotkv-mcp/","firstSeenAt":"2026-10-12T14:24:43.031Z","fetchedAt":"2026-10-24T17:27:36.814Z","normalizedAt":"2026-10-24T17:27:36.814Z"}]},"firstSeenAt":"2026-10-12T14:24:43.031Z","updatedAt":"2026-10-24T17:29:04.974Z"}