{"id":"sourabh-khot65-typesense-mcp-server","name":"typesense-mcp-server","homepage":null,"repo_url":"https://github.com/sourabh-khot65/typesense-mcp-server","category":"search","subcategories":[],"tags":["mcp","typesense","search","filtering","pagination","go","api-integration","agent-tools"],"what_it_does":"Provides an MCP (Model Context Protocol) server that lets an MCP client query a Typesense instance to perform searches against one or more Typesense collections, exposing a tool (typesense_search) that accepts typical Typesense search parameters and supports filtering/faceting plus pagination.","use_cases":["Integrate Typesense search into AI agents via MCP (e.g., Claude/Cursor)","Tool-based semantic/search workflows where the agent needs to query specific Typesense collections","Building agent-driven search experiences with filter expressions and pagination","Prototype a generic search tool across multiple Typesense collections"],"not_for":["Bulk indexing or ingestion workloads","Applications needing write operations/updates (the described tool is for search/retrieval only)","Environments that require OAuth/SSO-based auth flows (only API-key-like auth is documented)","Hard multi-tenant environments that need strong per-user authorization and audit controls"],"best_when":"You need a simple, generic MCP tool for read-only Typesense querying with common search controls (query_by/filter_by/page/per_page).","avoid_when":"You cannot provide a Typesense API key securely, or you require explicit, documented MCP tool schemas, error codes, and rate-limit behavior.","alternatives":["Typesense official API (REST) directly","A dedicated MCP wrapper that includes strict schemas per tool and documented error handling (if available)","Using a server-side function/tool that calls Typesense REST and returns normalized results to the agent"],"af_score":41.5,"security_score":33.8,"reliability_score":12.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:41:54.480603+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Typesense API key via environment variable (TYPESENSE_API_KEY)"],"oauth":false,"scopes":false,"notes":"README documents a single Typesense API key configuration via env var. No additional MCP auth mechanism (e.g., client auth, per-request credentials) is described."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information for the MCP server is provided; costs would depend on Typesense hosting and usage."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":41.5,"security_score":33.8,"reliability_score":12.5,"mcp_server_quality":60.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":75.0,"rate_limit_clarity":0.0,"tls_enforcement":30.0,"auth_strength":45.0,"scope_granularity":15.0,"dependency_hygiene":50.0,"secret_handling":30.0,"security_notes":"TLS enforcement is not clearly stated beyond a configurable protocol env var; if set to http, traffic may be unencrypted. Auth is via a single Typesense API key without documented per-tool/per-tenant scoping. Secret handling best practices are not described (only that TYPESENSE_API_KEY has a default value in README, which is a potential insecure practice indicator). No additional MCP-layer authentication/authorization is documented.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":0.0,"error_recovery":20.0,"idempotency_support":"true","idempotency_notes":"Search is read-only; retries should be safe assuming the tool does not create side effects. Idempotency is therefore likely, but not explicitly documented.","pagination_style":"page/per_page (1-based)","retry_guidance_documented":false,"known_agent_gotchas":["Ensure correct Typesense parameter formatting for filter_by (e.g., field:value, operators) because the tool forwards search parameters.","page is 1-based and per_page has a max (documented as max 100); agents should respect these bounds.","If TYPESENSE_PROTOCOL is set to https but the server is not configured for TLS, requests may fail; README defaults to http.","If query_by is omitted, it defaults to '*', which may increase load/cost and broaden search unexpectedly."]}}