English Français العربية

RyRank

Registre officiel Autres

Cohere-compatible pay-per-call reranker, no signup, x402/USDC

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package ryrank-mcp
Claude Code 
claude mcp add ryrank -e 'RYRANK_API=https://trigeochiral.com' -e 'RYRANK_XPAYMENT=<your ryrank_xpayment>' -- uvx ryrank-mcp==1.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ryrank": {
            "command": "uvx",
            "args": [
                "ryrank-mcp==1.0.0"
            ],
            "env": {
                "RYRANK_API": "https://trigeochiral.com",
                "RYRANK_XPAYMENT": "<your ryrank_xpayment>"
            }
        }
    }
}

Variables d'environnement

  • RYRANK_API obligatoire Base URL of the hosted RyRank API (default https://trigeochiral.com)
  • RYRANK_XPAYMENT secret Optional base64 x402 X-PAYMENT payload for paid calls past the free tier

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. RyRank — MCP server
  2. Tool
  3. Why
  4. Install
  5. Direct HTTP (no MCP)
  6. License

RyRank — MCP server

A Cohere-compatible reranker, pay-per-call in USDC on Base (x402), free tier, no signup.

Hosted API: https://trigeochiral.com — set it as RYRANK_API.

Tool

ToolWhat
rerankRerank documents by relevance to a query. Cohere-compatible response shape (results: [{index, relevance_score}]), so it drops into an existing co.rerank() call. ~$0.001/call over x402 (roughly half Cohere Rerank's list price) or a free tier.

Why

A hybrid reranker, not a cross-encoder: strong when the candidates already share vocabulary with the query, which is the common case for RAG retrieval output and document/tool shortlists. Built for high-volume, latency- and cost-sensitive reranking — narrowing a retrieval candidate set, deduping, triage — rather than close semantic disambiguation between near-identical phrasings. Pay-per-call and about half the price is the trade for that.

Verified against the real cohere.Client, cohere.ClientV2 and voyageai.Client SDKs: point base_url at this API and existing rerank code runs unmodified.

Install

pip install ryrank-mcp
claude mcp add ryrank --env RYRANK_API=https://trigeochiral.com -- ryrank-mcp

or with uvx (no install):

claude mcp add ryrank --env RYRANK_API=https://trigeochiral.com -- uvx ryrank-mcp

Optional: RYRANK_XPAYMENT = a base64 x402 X-PAYMENT payload, to make paid calls past the free tier. Without it you get 25 free calls/day per IP.

Direct HTTP (no MCP)

curl -sX POST https://trigeochiral.com/v1/rerank -H 'content-type: application/json' \
  -d '{"query":"how do I reset my password","documents":["Go to Settings > Security and click Reset Password.","Our refund policy allows returns within 30 days."],"top_n":2}'

Also speaks the exact Cohere v2 (POST /v2/rerank) and Voyage (POST /voyage/v1/rerank) request and response shapes, so their official SDKs work unmodified with just a base_url override — see https://trigeochiral.com for details.

License

MIT

Questions fréquentes

Qu'est-ce que RyRank ?

Cohere-compatible pay-per-call reranker, no signup, x402/USDC

Comment installer RyRank ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add ryrank -e 'RYRANK_API=https://trigeochiral.com' -e 'RYRANK_XPAYMENT=<your ryrank_xpayment>' -- uvx ryrank-mcp==1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour RyRank ?

Oui. Il attend RYRANK_API, RYRANK_XPAYMENT, à renseigner dans sa configuration.

RyRank est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient RyRank ?

Il est publié par trigeochiral. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.