MCP Server
AimRank
io.aimrank/aimrank
What this MCP does
Provides public pairwise rankings, predictions, leaderboards, similarity search, and statistical quality and agreement analysis.
Capabilities
Tools
21
tools
aimrank_create_share_card
Return share-ready URLs + embed snippets for a ranking.
Formats: "all" (default — everything), "twitter", "linkedin",
"embed_leaderboard", "embed_vote", "badge_markdown", "qr_code",
"data_card". Pass these to a human to paste into a tweet, blog,
Notion page, or Slack message. The OG image renders automatically
when the public_url is unfurled by Twitter / LinkedIn / Slack.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'create_share_cardArguments', 'required': ['ranking_id'], 'properties': {'format': {'type': 'string', 'title': 'Format', 'default': 'all'}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'create_share_cardOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_discover_public_rankings
Browse public rankings — agent equivalent of surfing aimrank.io.
Filters: category, media_type ("text" | "image" | "audio" | "video"),
sort ("trending" | "recent" | "most_votes" | "random"), limit 1-50.
Each result embeds share assets so the agent can hand any ranking
back to the user as a clickable link without a follow-up call.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'discover_public_rankingsArguments', 'properties': {'sort': {'type': 'string', 'title': 'Sort', 'default': 'trending'}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 10}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'media_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Media Type', 'default': None}}}
Output schema
{'type': 'object', 'title': 'discover_public_rankingsOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_explain
iCOMPLY contract: explain a prediction in features + narrative.
Returns the Glicko-2 μ/φ inputs for both entities + a deterministic
narrative. No LLM-synthesised rationale — these are the actual
numbers the math uses, which is exactly what an Annex IV auditor
needs to trace.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'icomply_explainArguments', 'required': ['ranking_id', 'entity_a_id', 'entity_b_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'entity_a_id': {'type': 'string', 'title': 'Entity A Id'}, 'entity_b_id': {'type': 'string', 'title': 'Entity B Id'}}}
Output schema
{'type': 'object', 'title': 'icomply_explainOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_find_similar_domains
Find public domains most similar to a query or a known domain.
Use ``query`` for free-text search ("pharma evaluation") OR
``domain_id`` to find domains similar to one you already know.
Exactly one must be provided.
TF-IDF + cosine similarity over name + description + category +
declared constitution + objectives text. Cheap (no embedding API
calls), 5-minute in-process cache. Only public domains are
searched / returned. Score in [0, 1] — typical "useful match"
threshold is ≥0.15; "near duplicate" is ≥0.5.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'find_similar_domains_toolArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 10}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Query', 'default': None}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'domain_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Domain Id', 'default': None}, 'min_score': {'type': 'number', 'title': 'Min Score', 'default': 0.05}}}
Output schema
{'type': 'object', 'title': 'find_similar_domains_toolOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_agreement
Inter-annotator agreement — Layer 5. Returns Cohen's κ
(n=2 raters), Fleiss' κ, Krippendorff's α, Scott's π +
Landis-Koch interpretation, plus the multi-rater coverage report.
`min_raters` overrides the ranking's configured min_raters_per_pair.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_agreementArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'min_raters': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Raters', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'get_agreementOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_ceiling
Pairwise-κ ceiling from qualification attempts. The upper
bound any judge / RM can credibly hit on this domain — used to
pin the L3 pilot refund clause (refund if κ < ceiling - 5pp).
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_ceilingArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'min_overlapping_items': {'type': 'integer', 'title': 'Min Overlapping Items', 'default': 20}}}
Output schema
{'type': 'object', 'title': 'get_ceilingOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_crowd_bt
CrowdBT — joint fit of entity scores + per-annotator
reliability η. Surfaces noisy / anti-correlated raters
explicitly. Methodology audit, not a live engine.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_crowd_btArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'max_iterations': {'type': 'integer', 'title': 'Max Iterations', 'default': 300}, 'min_votes_per_entity': {'type': 'integer', 'title': 'Min Votes Per Entity', 'default': 2}, 'min_votes_per_annotator': {'type': 'integer', 'title': 'Min Votes Per Annotator', 'default': 5}}}
Output schema
{'type': 'object', 'title': 'get_crowd_btOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_daily_pair
Fetch today's Daily Pair — the trending matchup chosen at 00:00 UTC.
Pairs with the `vote_of_the_day` agent template. Returns the challenge
+ a fresh matchup. If the cron hasn't run yet, falls back via
ok=False so the agent can use `aimrank_get_matchup` instead.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_daily_pairArguments', 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}}}
Output schema
{'type': 'object', 'title': 'get_daily_pairOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_data_card
Auto data card — Layer 7. Provenance + IAA + coverage +
per-annotator quality + transitivity + qualification stats in
one synthesized markdown audit artefact.
Format: 'markdown' (default) or 'json' for structured summary.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_data_cardArguments', 'required': ['ranking_id'], 'properties': {'format': {'type': 'string', 'title': 'Format', 'default': 'markdown'}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'get_data_cardOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_domain
Get domain details including entity pool and competition list.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_domainArguments', 'required': ['domain_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'domain_id': {'type': 'string', 'title': 'Domain Id'}}}
Output schema
{'type': 'object', 'title': 'get_domainOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_leaderboard
Get the top N entities of a ranking sorted by rating.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_leaderboardArguments', 'required': ['ranking_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 10}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'get_leaderboardOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_matchup
Get the next pair of entities to evaluate.
Strategies: adaptive (default), swiss, balanced, random,
uncertainty, explore, information_gain.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_matchupArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'strategy': {'type': 'string', 'title': 'Strategy', 'default': 'adaptive'}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'get_matchupOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_plackett_luce
Plackett-Luce listwise ranking aggregation — OFFLINE AUDIT ONLY.
Reported post-hoc; it NEVER writes ratings, and setting it as a
ranking's algorithm returns 400. AimRank has 6 rating engines plus
2 offline aggregators (this and CrowdBT) — never describe it as an
8th rating algorithm.
Generalises Bradley-Terry to ranked lists. On pairwise data,
collapses to BT MLE — useful as a second-opinion aggregator.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_plackett_luceArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'max_iterations': {'type': 'integer', 'title': 'Max Iterations', 'default': 300}, 'min_appearances_per_entity': {'type': 'integer', 'title': 'Min Appearances Per Entity', 'default': 2}}}
Output schema
{'type': 'object', 'title': 'get_plackett_luceOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_get_ranking
Fetch a ranking's metadata + top 25 entities sorted by rating.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'get_rankingArguments', 'required': ['ranking_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'get_rankingOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_healthcheck
iCOMPLY contract: liveness + DB-connectivity probe.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'icomply_healthcheckArguments', 'properties': {}}
Output schema
{'type': 'object', 'title': 'icomply_healthcheckOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_list_competitions
List all competitions (open voting + brackets) in a domain.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'list_competitionsArguments', 'required': ['domain_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'domain_id': {'type': 'string', 'title': 'Domain Id'}}}
Output schema
{'type': 'object', 'title': 'list_competitionsOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_list_domain_entities
List all entities in a domain's pool sorted by rating.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'list_domain_entitiesArguments', 'required': ['domain_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'domain_id': {'type': 'string', 'title': 'Domain Id'}}}
Output schema
{'type': 'object', 'title': 'list_domain_entitiesOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_list_public_judges
Browse public judge-prompt artifacts shared by other users.
Filter by ``category`` (free-text), ``domain_id``, or both.
Sort options: ``fork_count`` (default — most-forked first),
``recent``, ``faithfulness``.
Returns artifact summaries WITHOUT the full prompt text — call
`aimrank_fork_judge_prompt` or the REST GET to retrieve the
full prompt before using it.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'list_public_judges_toolArguments', 'properties': {'sort': {'type': 'string', 'title': 'Sort', 'default': 'fork_count'}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'domain_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Domain Id', 'default': None}}}
Output schema
{'type': 'object', 'title': 'list_public_judges_toolOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_predict
iCOMPLY contract: pairwise prediction with provenance fields.
Returns the engine's predicted winner + probability shaped so
iCOMPLY's Annex IV section-4 generator can ingest the response
directly. See [iCOMPLY_INTEGRATION_STRATEGY.md] for the contract.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'icomply_predictArguments', 'required': ['ranking_id', 'entity_a_id', 'entity_b_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'entity_a_id': {'type': 'string', 'title': 'Entity A Id'}, 'entity_b_id': {'type': 'string', 'title': 'Entity B Id'}}}
Output schema
{'type': 'object', 'title': 'icomply_predictOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_predict_matchup_winner
Predict the winner of a matchup BEFORE a vote is cast.
Uses Glicko-2 win probability under the same formula matchmaking
uses internally. Pairs with aimrank_submit_vote for the
"Claude predicts, you vote, we compare" demo. Does not record
a vote — read-only.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'predict_matchup_winnerArguments', 'required': ['ranking_id', 'entity_a_id', 'entity_b_id'], 'properties': {'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}, 'entity_a_id': {'type': 'string', 'title': 'Entity A Id'}, 'entity_b_id': {'type': 'string', 'title': 'Entity B Id'}}}
Output schema
{'type': 'object', 'title': 'predict_matchup_winnerOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
aimrank_search_entities
Find entities by name substring within a ranking.
api_key is optional on the public endpoint; on /mcp/mcp a missing
key is refused.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'search_entitiesArguments', 'required': ['ranking_id', 'query'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20}, 'query': {'type': 'string', 'title': 'Query'}, 'api_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Api Key', 'default': None}, 'ranking_id': {'type': 'string', 'title': 'Ranking Id'}}}
Output schema
{'type': 'object', 'title': 'search_entitiesOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
History
Recent tool changes
Added
aimrank_healthcheck
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_explain
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_predict
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_find_similar_domains
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_list_public_judges
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_crowd_bt
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_plackett_luce
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_ceiling
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_agreement
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_data_card
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_list_competitions
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_domain
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_list_domain_entities
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_discover_public_rankings
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_predict_matchup_winner
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_create_share_card
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_search_entities
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_matchup
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_leaderboard
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_ranking
Sept. 17, 2026, 12:39 p.m.
Added
aimrank_get_daily_pair
Sept. 17, 2026, 12:39 p.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Crypto & DeFi
com.stratalize/crypto
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…