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

Argument	Type	Description
format	string
api_key	any
ranking_id*	string

Input schema (JSON)

{
  "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": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

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

Argument	Type	Description
sort	string
limit	integer
api_key	any
category	any
media_type	any

Input schema (JSON)

{
  "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": null
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "default": null
    },
    "media_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Media Type",
      "default": null
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
entity_a_id*	string
entity_b_id*	string

Input schema (JSON)

{
  "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": null
    },
    "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"
    }
  }
}

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

Argument	Type	Description
limit	integer
query	any
api_key	any
domain_id	any
min_score	number

Input schema (JSON)

{
  "type": "object",
  "title": "find_similar_domains_toolArguments",
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Query",
      "default": null
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "domain_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain Id",
      "default": null
    },
    "min_score": {
      "type": "number",
      "title": "Min Score",
      "default": 0.05
    }
  }
}

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

Argument	Type	Description
api_key	any
min_raters	any
ranking_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_agreementArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "min_raters": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Raters",
      "default": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
min_overlapping_items	integer

Input schema (JSON)

{
  "type": "object",
  "title": "get_ceilingArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    },
    "min_overlapping_items": {
      "type": "integer",
      "title": "Min Overlapping Items",
      "default": 20
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
max_iterations	integer
min_votes_per_entity	integer
min_votes_per_annotator	integer

Input schema (JSON)

{
  "type": "object",
  "title": "get_crowd_btArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "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
    }
  }
}

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

Argument	Type	Description
api_key	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_daily_pairArguments",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    }
  }
}

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

Argument	Type	Description
format	string
api_key	any
ranking_id*	string

Input schema (JSON)

{
  "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": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

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

Argument	Type	Description
api_key	any
domain_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_domainArguments",
  "required": [
    "domain_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "domain_id": {
      "type": "string",
      "title": "Domain Id"
    }
  }
}

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

Argument	Type	Description
limit	integer
api_key	any
ranking_id*	string

Input schema (JSON)

{
  "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": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

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

Argument	Type	Description
api_key	any
strategy	string
ranking_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_matchupArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "strategy": {
      "type": "string",
      "title": "Strategy",
      "default": "adaptive"
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
max_iterations	integer
min_appearances_per_entity	integer

Input schema (JSON)

{
  "type": "object",
  "title": "get_plackett_luceArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "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
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_rankingArguments",
  "required": [
    "ranking_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

aimrank_healthcheck

iCOMPLY contract: liveness + DB-connectivity probe.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "title": "icomply_healthcheckArguments",
  "properties": {}
}

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

Argument	Type	Description
api_key	any
domain_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "list_competitionsArguments",
  "required": [
    "domain_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "domain_id": {
      "type": "string",
      "title": "Domain Id"
    }
  }
}

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

Argument	Type	Description
api_key	any
domain_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "list_domain_entitiesArguments",
  "required": [
    "domain_id"
  ],
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Api Key",
      "default": null
    },
    "domain_id": {
      "type": "string",
      "title": "Domain Id"
    }
  }
}

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

Argument	Type	Description
sort	string
limit	integer
api_key	any
category	any
domain_id	any

Input schema (JSON)

{
  "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": null
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "default": null
    },
    "domain_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Domain Id",
      "default": null
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
entity_a_id*	string
entity_b_id*	string

Input schema (JSON)

{
  "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": null
    },
    "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"
    }
  }
}

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

Argument	Type	Description
api_key	any
ranking_id*	string
entity_a_id*	string
entity_b_id*	string

Input schema (JSON)

{
  "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": null
    },
    "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"
    }
  }
}

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

Argument	Type	Description
limit	integer
query*	string
api_key	any
ranking_id*	string

Input schema (JSON)

{
  "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": null
    },
    "ranking_id": {
      "type": "string",
      "title": "Ranking Id"
    }
  }
}

AimRank

Try it

aimrank_create_share_card Read-only

AimRank

Try it

aimrank_create_share_card Read-only

Tools (21)