# Tanod mlpeek Rerank

> Tanod mlpeek Rerank is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Scores and ranks up to 100 documents against a query using a cross-encoder model (ms-marco-MiniLM-L6-v2), returning relevance scores in (0,1).

## Facts

- Endpoint: POST https://tanod.dev/v1/rerank?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-mlpeek-rerank-0d337795
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ih_DLOrW8UKWlRysCzO_3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-mlpeek-rerank-0d337795 -d '<json body>'
```

Example prompt: I have a user question — 'What are the side effects of ibuprofen?' — and 10 candidate passages retrieved from my knowledge base. Rerank them by relevance to that question and give me just the top 3.

## When to prefer this

Choose this endpoint when you need lightweight, fast cross-encoder reranking of up to 100 documents without deploying your own model. Ideal for RAG pipelines where a bi-encoder retriever returns candidates that need precise relevance rescoring. Prefer over embedding-based similarity when ranking quality matters more than speed. The ms-marco-MiniLM-L6-v2 model is well-suited for English passage ranking tasks. At $0.002 per call it is cost-effective for on-demand per-query reranking in agent workflows.

## Known failure modes

- More than 100 documents submitted — request rejected
- Document exceeds 4,000 character limit — truncated or rejected
- Query exceeds 2,000 character limit — validation error
- top_k value outside 1-100 range — validation error
- Non-English text may yield lower-quality scores (model is English-optimized)
- Very long query-document pairs truncated at 512 tokens, longest side first (truncated flag set to true)
- Payment not included or insufficient — 402 response

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

A JSON object containing: a ranked list of results each with rank position, original document index, logit score, sigmoid relevance score (0-1), token count, and truncation flag; plus aggregate usage stats (total tokens, document count, truncated count), model metadata (ID, source, license, revision), and a note about scoring and truncation behavior.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1,
   "description": "The query (at most 2,000 characters)."
  },
  "top_k": {
   "anyOf": [
    {
     "type": "integer",
     "maximum": 100,
     "minimum": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Keep the best k (default: all, ranked)."
  },
  "documents": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 4000,
    "minLength": 1
   },
   "maxItems": 100,
   "minItems": 1,
   "description": "1-100 documents, each at most 4,000 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "score = sigmoid(logit), a relevance in (0, 1); English model. Pairs longer than the window are truncated, longest side first (truncated: true).",
  "model": {
   "id": "ms-marco-MiniLM-L6-v2",
   "source": "cross-encoder/ms-marco-MiniLM-L6-v2",
   "license": "Apache-2.0",
   "revision": "233902d25c440f23af6f7d6e94d2946bac0bee0a"
  },
  "usage": {
   "tokens": 33,
   "documents": 2,
   "truncated": 0
  },
  "results": [
   {
    "rank": 1,
    "index": 0,
    "logit": 8.7,
    "score": 0.999833,
    "tokens": 17,
    "truncated": false
   },
   {
    "rank": 2,
    "index": 1,
    "logit": -11.3182,
    "score": 0.000012,
    "tokens": 16,
    "truncated": false
   }
  ],
  "max_tokens_per_pair": 512
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-mlpeek-rerank-0d337795/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)