English Français العربية

RyRank

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • RYRANK_API required 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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is RyRank?

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

How do I install RyRank?

It runs on your machine. In Claude Code: claude mcp add ryrank -e 'RYRANK_API=https://trigeochiral.com' -e 'RYRANK_XPAYMENT=<your ryrank_xpayment>' -- uvx ryrank-mcp==1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does RyRank need an API key?

Yes. It expects RYRANK_API, RYRANK_XPAYMENT, which you set in its configuration.

Is RyRank open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains RyRank?

It is published by trigeochiral. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.