nexus_similarity_search_api_score_pair_nmi_cosine
ActiveTool of io.github.nexus-mcp-infra/similarity-search-api-sdk
declared in 1.28.1
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 a valid api_key (same as X-API-Key) and an x402 payment.
Parameters schema
{
"type": "object",
"title": "score_pair_nmi_cosineArguments",
"required": [
"vector_a",
"vector_b",
"api_key"
],
"properties": {
"alpha": {
"type": "number",
"title": "Alpha",
"default": 0.5,
"maximum": 1,
"minimum": 0,
"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."
},
"n_bins": {
"type": "number",
"title": "N Bins",
"default": 16,
"maximum": 50,
"minimum": 3,
"description": "Histogram bins for NMI discretization. Must be between 3 and 50."
},
"api_key": {
"type": "string",
"title": "Api Key",
"description": "API key required for this paid operation -- same secret configured as X-API-Key on the REST endpoints (SIMILARITY_API_KEY). Payment (x402) alone is not sufficient; both gates must pass."
},
"vector_a": {
"type": "array",
"items": {
"type": "number"
},
"title": "Vector A",
"maxItems": 4096,
"minItems": 2,
"description": "First dense numeric vector of the pair. Must have the same dimensionality as vector_b."
},
"vector_b": {
"type": "array",
"items": {
"type": "number"
},
"title": "Vector B",
"maxItems": 4096,
"minItems": 2,
"description": "Second dense numeric vector of the pair. Must have the same dimensionality as vector_a."
}
}
}Parent server
io.github.nexus-mcp-infra/similarity-search-api-sdk
https://github.com/nexus-mcp-infra/similarity-search-api-sdk
1/7 registries