{"name":"io.github.nexus-mcp-infra/similarity-search-api-sdk","slug":"nexus-mcp-infra-similarity-search-api-sdk","title":null,"description":"Stateless NMI + cosine fusion with entropy-driven alpha calibration","url":"https://mcp.market/server/nexus-mcp-infra-similarity-search-api-sdk","rating":null,"grade":"D","score":40,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":15,"stars":0,"forks":0,"downloads_week":null,"last_push_at":"2026-09-01T21:12:46.000Z","license":null},"uptime":{"percent":43,"checks":28,"ok":12,"last_checked_at":"2026-11-04T08:55:26.424Z","last_ok_at":"2026-10-29T10:45:39.928Z","latency_ms":968},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/nexus-mcp-infra/similarity-search-api-sdk","website":null,"version":"1.0.0","remotes":[{"type":"streamable-http","url":"https://similarity-search-api-production.up.railway.app/mcp"}],"packages":[],"tools":[{"name":"nexus_similarity_search_api_estimate_corpus_entropy_profile","description":"Computes the aggregate entropy-calibrated alpha for a corpus without running a full search -- useful to inspect before committing to a large rank_items_by_nmi_cosine_fusion call. Returns a single aggregate corpus_entropy value, NOT a per-dimension breakdown -- the real logic only exposes the mean marginal entropy across dimensions, not H(X_d) per individual dimension. Do NOT use expecting per-dimension granularity. Requires an x402 payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"corpus_vectors":{"description":"List of dense numeric vectors for which to compute the aggregate entropy and calibrated alpha. Each inner array must be the same length. Maximum 500000 entries.","items":{"items":{"type":"number"},"type":"array"},"maxItems":500000,"minItems":1,"title":"Corpus Vectors","type":"array"},"n_bins":{"default":16,"description":"Number of histogram bins for entropy discretization. Must be between 3 and 50; should match the n_bins used in rank_items_by_nmi_cosine_fusion for the profile to be consistent.","maximum":50,"minimum":3,"title":"N Bins","type":"number"}},"required":["corpus_vectors"],"title":"estimate_corpus_entropy_profileArguments"}},{"name":"nexus_similarity_search_api_rank_items_by_nmi_cosine_fusion","description":"Ranks a corpus of items against a query vector using a calibrated fusion score (alpha * cosine + (1-alpha) * NMI_normalizado), where alpha is auto-derived from the corpus's marginal entropy unless overridden. Results are identified by their 0-indexed position in corpus_vectors (this tool does not accept explicit item IDs). Use this when you need semantically-calibrated similarity over a stateless corpus of up to 500k items without a vector database. Do NOT use for purely geometric nearest-neighbor search where NMI overhead is unnecessary, nor for corpora larger than 500k items per call. Requires an x402 payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query_vector":{"description":"Dense numeric vector representing the query item. Must have the same dimensionality as all corpus_vectors entries.","items":{"type":"number"},"maxItems":4096,"minItems":2,"title":"Query Vector","type":"array"},"corpus_vectors":{"description":"List of dense numeric vectors forming the corpus to rank against. Each inner array must match query_vector dimensionality. Maximum 500000 entries.","items":{"items":{"type":"number"},"type":"array"},"maxItems":500000,"minItems":1,"title":"Corpus Vectors","type":"array"},"top_k":{"default":10,"description":"Number of top-ranked results to return, ordered by descending fusion score. Capped at 1000 by the core service regardless of corpus size.","maximum":1000,"minimum":1,"title":"Top K","type":"number"},"alpha_override":{"default":null,"description":"Fixed alpha weight for cosine component in [0.0, 1.0]. If omitted, alpha is auto-calibrated from corpus entropy. Set to 1.0 to use pure cosine; 0.0 for pure NMI.","maximum":1,"minimum":0,"title":"Alpha Override","type":"number"},"n_bins":{"default":16,"description":"Number of histogram bins used to discretize continuous dimensions when estimating NMI. Must be between 3 and 50.","maximum":50,"minimum":3,"title":"N Bins","type":"number"}},"required":["query_vector","corpus_vectors"],"title":"rank_items_by_nmi_cosine_fusionArguments"}},{"name":"nexus_similarity_search_api_score_pair_nmi_cosine","description":"Computes the NMI-cosine fusion score for exactly one (query, target) vector pair at a fixed alpha. Use for explainability, debugging, or unit-level validation of fusion scores before running full corpus ranking. Unlike corpus-level ranking, alpha is NOT auto-calibrated for a single pair -- the real logic requires a fixed alpha (default 0.5); pass alpha explicitly for a specific blend. Do NOT use in a loop to score many pairs; batch them into rank_items_by_nmi_cosine_fusion instead. Requires an x402 payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"vector_a":{"description":"First dense numeric vector of the pair. Must have the same dimensionality as vector_b.","items":{"type":"number"},"maxItems":4096,"minItems":2,"title":"Vector A","type":"array"},"vector_b":{"description":"Second dense numeric vector of the pair. Must have the same dimensionality as vector_a.","items":{"type":"number"},"maxItems":4096,"minItems":2,"title":"Vector B","type":"array"},"n_bins":{"default":16,"description":"Histogram bins for NMI discretization. Must be between 3 and 50.","maximum":50,"minimum":3,"title":"N Bins","type":"number"},"alpha":{"default":0.5,"description":"Fixed alpha weight for the cosine component in [0.0, 1.0], applied as-is -- not auto-calibrated. Default 0.5 matches the core service default.","maximum":1,"minimum":0,"title":"Alpha","type":"number"}},"required":["vector_a","vector_b"],"title":"score_pair_nmi_cosineArguments"}}],"scan":{"score":40,"grade":"D","scanned_at":"2026-10-31T05:51:47.726Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-31T05:51:47.659Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":0,"max":20,"notes":["remote unreachable: Streamable HTTP error: Error POSTing to endpoint: {\"status\":\"error\",\"code\":404,\"message\":\"Application not found\",\"request_id\":\"f0HQEZbKTvqUmStbnpoFkQ\"}"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (endpoint requires auth); not counted"]},"auth":{"score":5,"max":15,"notes":["no auth information"]},"maintenance":{"score":12,"max":15,"notes":["last push 59 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[{"id":"reliability.unreachable","severity":"high","component":"reliability","title":"Remote endpoint did not respond","detail":"Streamable HTTP error: Error POSTing to endpoint: {\"status\":\"error\",\"code\":404,\"message\":\"Application not found\",\"request_id\":\"f0HQEZbKTvqUmStbnpoFkQ\"}"}],"inputs":{"probes":[{"url":"https://similarity-search-api-production.up.railway.app/mcp","reachable":false,"authRequired":false,"latencyMs":187,"error":"Streamable HTTP error: Error POSTing to endpoint: {\"status\":\"error\",\"code\":404,\"message\":\"Application not found\",\"request_id\":\"f0HQEZbKTvqUmStbnpoFkQ\"}"}],"packages":[],"repo":{"found":true,"owner":"nexus-mcp-infra","repo":"similarity-search-api-sdk","archived":false,"pushedAt":"2026-09-01T21:12:46Z","stars":0,"forks":0,"openIssues":0,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/297982310?v=4","ownerCreatedAt":"2026-06-29T16:52:26Z"},"icon":{"url":null,"source":"none"},"presence":{"stars":0,"forks":0,"downloadsWeek":null,"license":null,"lastPushAt":"2026-09-01T21:12:46.000Z","score":15}}}},"grade_history":[{"kind":"downgrade","fromGrade":"A","toGrade":"D","reason":"score 40: Remote endpoint did not respond","createdAt":"2026-10-31T05:51:48.174Z"}],"reviews":[]}