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
| Tool | What |
|---|---|
rerank |
Rerank 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 lexical+spectral 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
1 maintainer
Metadata
1 maintainer
Release files for ryrank-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| ryrank_mcp-1.0.0.tar.gz | 5.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ryrank_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.0 kB
Release files / ryrank_mcp-1.0.0.tar.gz
| Download URL | ryrank_mcp-1.0.0.tar.gz |
|---|---|
| Size | 5.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5e298b262eba42d0dc671362d4452261f869a9af29570eea366ea6994ca50ad6
|
|
BLAKE2b-256 checksum How to use checksums |
b840bf12ac7d9a8ad1e7693d9dfc1831db3f344815f0fda2978482a0d34f302e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / ryrank_mcp-1.0.0-py3-none-any.whl
| Download URL | ryrank_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5ac425b3e8dd2eddf4c1b009e3f4448b0e42533206e972f5560ac5a86ec9e880
|
|
BLAKE2b-256 checksum How to use checksums |
878a2b5770775d545949dabf1855620c02c068fd7a4c55ea58ccf5d767e98584
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for ryrank-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
