TypesenseKit MCP server

TypesenseKit

Operate Typesense from your terminal or AI agent

TypesenseKit is an independent, open-source CLI and MCP server for Typesense. Inspect collections, run searches, and check cluster health from your terminal or a compatible AI assistant.

Both interfaces share 95 operations with validated inputs. MCP access is read-only by default; enabling full access exposes write, delete, key-management, and raw API tools. Use a scoped Typesense API key to restrict what the server can access.

Website · Typesense CLI · Typesense MCP · Guides

Requires Node.js 22.11 or newer and access to a Typesense cluster. The search example assumes an existing products collection with a title field.

pnpm add -g @typesensekit/cli

# Securely prompts for the API key
tsk profile add local --url http://localhost:8108
tsk profile use local

# Discover the input, then run the operation
tsk documents.search --examples
tsk documents.search --input '{"collection":"products","params":{"q":"oak chair","query_by":"title"}}' --json

Why TypesenseKit

Typesense work often jumps between dashboards, one-off scripts, local curl commands, and agent experiments. TypesenseKit keeps those workflows on one predictable surface:

• Use the same operation names from the CLI and MCP server.
• Validate structured inputs before requests reach Typesense.
• Get readable terminal output or stable, redacted JSON for scripts.
• Keep secrets out of shell history with secure prompts, stdin, or macOS Keychain profiles.
• Confirm destructive CLI operations before they run.
• Give AI clients read-only tools by default, then opt in to writes deliberately.
• Reach newer or uncommon endpoints through the raw api.call escape hatch.

Use the official Typesense client in application code. Use TypesenseKit when humans, scripts, and agents need to perform the same operational work.

CLI

Install the public CLI package:

pnpm add -g @typesensekit/cli

Create a profile interactively, pipe a key over stdin for automation, or use macOS Keychain:

# Interactive secure prompt
tsk profile add local --url http://localhost:8108

# Scripted setup without putting the key in argv or shell history
printf '%s' "$TYPESENSE_API_KEY" | tsk profile add ci \
  --url https://search.example.com --api-key-stdin

# Keychain-backed profile on macOS
tsk profile add production --url https://search.example.com --keychain

Every operation supports generated schemas and examples. Common results render as tables; pass --json for stable automation output.

tsk operations
tsk collections.list --input '{}'
tsk documents.search --schema
tsk documents.search --examples
tsk collections.list --input '{}' --json

Enable shell completion:

source <(tsk completion zsh)
source <(tsk completion bash)
tsk completion fish | source

See the Typesense CLI overview or read the complete CLI guide for profiles, environment-only use, JSON input, completion, and destructive-operation behavior.

MCP Server

Shortened. The full README is on GitHub.