English Français العربية

RyRank

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • RYRANK_API إلزامي Base URL of the hosted RyRank API (default https://trigeochiral.com)
  • RYRANK_XPAYMENT سري Optional base64 x402 X-PAYMENT payload for paid calls past the free tier

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو RyRank؟

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

كيف أثبّت RyRank؟

يعمل على جهازك. في Claude Code: claude mcp add ryrank -e 'RYRANK_API=https://trigeochiral.com' -e 'RYRANK_XPAYMENT=<your ryrank_xpayment>' -- uvx ryrank-mcp==1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج RyRank إلى مفتاح API؟

نعم. يتطلب RYRANK_API, RYRANK_XPAYMENT، وتضبطها في إعداداته.

هل RyRank مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون RyRank؟

ينشره trigeochiral. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.