OkkMax MCP
Read-only access to OkkMax's independent review and ranking data for AI API relay stations, including metrics on purity, uptime, speed, and price per model.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.okkmax.com/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to okkmax.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Compare relays for one model
- Vet one relay's purity and uptime
- Find the lowest-priced relay for one model under an uptime threshold
Source and maintenance
Protocol and capabilities
- Server
- okkmax 0.2.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
search_stations — Search relay stations
Search relay services tracked by OkkMax by station name, slug, domain, URL, or model ID. Returns matching relays in leaderboard order with their current metrics. Use get_station for a full report.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results (1-50, default 10)."
},
"query": {
"type": "string",
"maxLength": 100,
"description": "Free text: a relay name, slug, domain or URL, or a model ID such as claude-opus. Omit to list the top of the leaderboard."
},
"locale": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en",
"description": "Language of the human-readable text (statement, reason, notes, suggestions) and of the OkkMax page links. Pass zh when the user writes Chinese, otherwise en. Field names and data values are the same either way."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"total",
"stations",
"dataAsOf"
],
"properties": {
"total": {
"type": "number"
},
"dataAsOf": {
"type": [
"string",
"null"
],
"description": "ISO 8601 time the underlying OkkMax data was last updated (not the time of this response). null when unavailable."
},
"stations": {
"type": "array",
"items": {
"type": "object",
"required": [
"rank",
"slug",
"name",
"rankScore",
"purityTier",
"purityIndex",
"availIndex",
"speedIndex",
"modelCount",
"startingInputPricePer1M",
"currency",
"billingUnit",
"reviewCount",
"reviewAvg",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"rank": {
"type": [
"number",
"null"
]
},
"slug": {
"type": "string"
},
"currency": {
"enum": [
"CNY",
"USD"
],
"type": "string"
},
"rankScore": {
"type": [
"number",
"null"
]
},
"reviewAvg": {
"type": [
"number",
"null"
]
},
"availIndex": {
"type": [
"number",
"null"
]
},
"modelCount": {
"type": "number"
},
"purityTier": {
"type": [
"string",
"null"
]
},
"speedIndex": {
"type": [
"number",
"null"
]
},
"billingUnit": {
"type": "string"
},
"purityIndex": {
"type": [
"number",
"null"
]
},
"reviewCount": {
"type": "number"
},
"startingInputPricePer1M": {
"type": [
"number",
"null"
],
"description": "Lowest input price across ALL models this relay lists. It is the relay's entry price, not the price of any specific model: use get_model_board or get_station with model for a model's price."
}
},
"additionalProperties": false
}
},
"suggestions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Present when nothing matched: what to try next."
}
},
"additionalProperties": false
}{
"title": "Search relay stations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_models — Search models
Search the AI models that relays resell (Claude, GPT/Codex, Gemini, and others) with OkkMax model pages. Returns the canonical slug to pass to get_model_board or find_cheapest_relay, how many monitored relays sell the model, and the official vendor price in USD per 1M tokens. Other spellings of the same version (for example claude-sonnet-4.6 for claude-sonnet-4-6) are listed in aliases, not as separate models; their relay counts are not merged.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results (1-50, default 10)."
},
"query": {
"type": "string",
"maxLength": 100,
"description": "Free text, e.g. opus, gpt, gemini. Omit to list popular models first."
},
"locale": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en",
"description": "Language of the human-readable text (statement, reason, notes, suggestions) and of the OkkMax page links. Pass zh when the user writes Chinese, otherwise en. Field names and data values are the same either way."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"total",
"models",
"dataAsOf"
],
"properties": {
"total": {
"type": "number"
},
"models": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"family",
"relayCount",
"aliases",
"officialPriceUsdPer1M",
"contextLength",
"released",
"url"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Canonical slug: pass this to get_model_board and find_cheapest_relay."
},
"title": {
"type": "string"
},
"family": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"relayCount",
"url"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"relayCount": {
"type": "number"
}
},
"additionalProperties": false
},
"description": "Other spellings of the same version (for example 4.6 for 4-6) that OkkMax lists as separate pages. Relays under an alias are not in this model's board or in find_cheapest_relay."
},
"released": {
"type": [
"string",
"null"
]
},
"relayCount": {
"type": "number",
"description": "Relays listed under exactly this slug. Alias slugs are counted separately in aliases, never merged in."
},
"contextLength": {
"type": [
"number",
"null"
]
},
"officialPriceUsdPer1M": {
"type": "object",
"required": [
"input",
"output"
],
"properties": {
"input": {
"type": [
"number",
"null"
]
},
"output": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"dataAsOf": {
"type": [
"string",
"null"
],
"description": "ISO 8601 time the underlying OkkMax data was last updated (not the time of this response). null when unavailable."
},
"suggestions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Present when nothing matched: what to try next."
}
},
"additionalProperties": false
}{
"title": "Search models",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_model_board — Get relay leaderboard for a model
For one model, list the monitored relays that sell it, one row per relay using its highest-uptime group: input/output/cache price per 1M tokens in the relay's own currency (CNY or USD), 24h uptime and latency. Sorted by uptime, then price. Paged with limit and offset: total, returned, hasMore and nextOffset say whether the page is complete, and coversAllRelays is true only when it holds the whole board. This is not a price ranking and includes USD-priced relays and promotional groups; for the lowest price under an uptime condition use find_cheapest_relay.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results (1-50, default 10)."
},
"model": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Model slug as used on OkkMax, e.g. claude-opus-5-5 or gpt-6-astra. Dated aliases and other spellings of the same version (4.6 for 4-6) are accepted and resolved to the canonical slug. Use search_models to find slugs."
},
"locale": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en",
"description": "Language of the human-readable text (statement, reason, notes, suggestions) and of the OkkMax page links. Pass zh when the user writes Chinese, otherwise en. Field names and data values are the same either way."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Rows to skip, for paging. Use nextOffset from the previous response while hasMore is true."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model",
"title",
"url",
"totalRelays",
"total",
"offset",
"returned",
"hasMore",
"nextOffset",
"coversAllRelays",
"officialPriceUsdPer1M",
"contextLength",
"note",
"billingUnit",
"relays",
"dataAsOf"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"model": {
"type": "string"
},
"title": {
"type": "string"
},
"total": {
"type": "number"
},
"offset": {
"type": "number"
},
"relays": {
"type": "array",
"items": {
"type": "object",
"required": [
"position",
"slug",
"name",
"group",
"otherGroups",
"inputPricePer1M",
"outputPricePer1M",
"cachePricePer1M",
"currency",
"uptime24hPercent",
"latencyMs",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"group": {
"type": "string"
},
"currency": {
"enum": [
"CNY",
"USD"
],
"type": "string"
},
"position": {
"type": "number"
},
"latencyMs": {
"type": [
"number",
"null"
]
},
"otherGroups": {
"type": "number"
},
"cachePricePer1M": {
"type": [
"number",
"null"
]
},
"inputPricePer1M": {
"type": [
"number",
"null"
]
},
"outputPricePer1M": {
"type": [
"number",
"null"
]
},
"uptime24hPercent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"hasMore": {
"type": "boolean",
"description": "true when more rows exist after this page. Request nextOffset to continue."
},
"dataAsOf": {
"type": [
"string",
"null"
],
"description": "ISO 8601 time the underlying OkkMax data was last updated (not the time of this response). null when unavailable."
},
"returned": {
"type": "number"
},
"nextOffset": {
"type": [
"number",
"null"
]
},
"aliasNotice": {
"type": "string"
},
"billingUnit": {
"type": "string"
},
"totalRelays": {
"type": "number",
"description": "Number of relays on the whole board (same as total)."
},
"contextLength": {
"type": [
"number",
"null"
]
},
"requestedModel": {
"type": "string",
"description": "Present only when the requested slug was another spelling of the canonical model; model then holds the canonical slug."
},
"coversAllRelays": {
"type": "boolean",
"description": "true only when this response contains every relay on the board (offset 0 and hasMore false). Only then may the rows be treated as the full candidate set."
},
"officialPriceUsdPer1M": {
"anyOf": [
{
"type": "object",
"required": [
"input",
"output"
],
"properties": {
"input": {
"type": [
"number",
"null"
]
},
"output": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}{
"title": "Get relay leaderboard for a model",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_cheapest_relay — Find the lowest-priced relay for a model
Find the relay with the lowest observed input price for one model, under these conditions: CNY-priced relays whose 24h uptime is at least minUptime24hPercent (default 90; pass the user's number when they name an uptime requirement), excluding first-top-up, trial and free promotional groups. Returns that one relay with its slug, group, price per 1M input tokens, 24h uptime, the filter criteria, the data time (dataAsOf) and the only wording the result supports for a price claim. It is a single filtered candidate, not an overall ranking: to compare several relays use get_model_board, and check purity with get_station before recommending.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Model slug as used on OkkMax, e.g. claude-opus-5-5 or gpt-6-astra. Dated aliases and other spellings of the same version (4.6 for 4-6) are accepted and resolved to the canonical slug. Use search_models to find slugs."
},
"locale": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en",
"description": "Language of the human-readable text (statement, reason, notes, suggestions) and of the OkkMax page links. Pass zh when the user writes Chinese, otherwise en. Field names and data values are the same either way."
},
"minUptime24hPercent": {
"type": "number",
"default": 90,
"maximum": 100,
"minimum": 0,
"description": "Minimum 24h uptime in percent (0-100, default 90). Set it to the uptime the user asked for, for example 99. Groups whose uptime is below it or not measured are excluded."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model",
"found",
"criteria",
"modelBoardUrl",
"dataAsOf"
],
"properties": {
"found": {
"type": "boolean"
},
"model": {
"type": "string"
},
"relay": {
"type": "object",
"required": [
"name",
"slug",
"group",
"inputPricePer1M",
"outputPricePer1M",
"cachePricePer1M",
"currency",
"billingUnit",
"uptime24hPercent",
"url"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"group": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
},
"billingUnit": {
"type": "string"
},
"cachePricePer1M": {
"type": [
"number",
"null"
]
},
"inputPricePer1M": {
"type": "number"
},
"outputPricePer1M": {
"type": [
"number",
"null"
]
},
"uptime24hPercent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"reason": {
"type": "string"
},
"criteria": {
"type": "object",
"required": [
"minUptime24hPercent",
"currency",
"priceBasis",
"billingUnit",
"scope",
"excludes"
],
"properties": {
"scope": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
},
"excludes": {
"type": "array",
"items": {
"type": "string"
}
},
"priceBasis": {
"type": "string"
},
"billingUnit": {
"type": "string"
},
"minUptime24hPercent": {
"type": "number"
}
},
"additionalProperties": false
},
"dataAsOf": {
"type": [
"string",
"null"
],
"description": "ISO 8601 time the underlying OkkMax data was last updated (not the time of this response). null when unavailable."
},
"statement": {
"type": "string",
"description": "The only wording this result supports for a price claim; it carries the filter, currency, unit and data time."
},
"aliasNotice": {
"type": "string"
},
"suggestions": {
"type": "array",
"items": {
"type": "string"
}
},
"modelBoardUrl": {
"type": "string"
},
"requestedModel": {
"type": "string"
}
},
"additionalProperties": false
}{
"title": "Find the lowest-priced relay for a model",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_station — Get a relay station report
OkkMax report for one relay station. Without model: the full report as markdown: rank and score breakdown, station-wide purity, per-channel availability and latency, groups and prices for every model, payment/refund terms and user review summary. With model (and optionally group): a compact JSON result for that one model only: the groups selling it with prices, each group's purity, and whether this model was directly probed in that group (selectedModelDirectlyVerified, actualModelSeen, detectedAt). Station-wide purity does not prove a specific model or group is genuine: when the user cares about one model, pass model. Promotions, invitation codes and invite links are not included. Use the slug from search_stations.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Station slug, e.g. from search_stations."
},
"group": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Group name; only with model. Narrows the result to that one group."
},
"model": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Model slug, e.g. claude-sonnet-5-5 (from search_models). Returns only this model's groups, prices and purity evidence as JSON. Omit for the full markdown report."
},
"locale": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en",
"description": "Language of the human-readable text (statement, reason, notes, suggestions) and of the OkkMax page links. Pass zh when the user writes Chinese, otherwise en. Field names and data values are the same either way."
}
}
}{
"title": "Get a relay station report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}explain_methodology — Explain OkkMax scoring methodology
Explain how OkkMax measures and scores relay stations: the rank score formula, the three purity tiers (pureblood, downgrade, counterfeit), how availability and speed are probed, detection cadence, how Sponsor ad placements relate to ranking, and the limits of the data. Returns markdown with a data timestamp. Call this before explaining a score to a user.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}{
"title": "Explain OkkMax scoring methodology",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1380 ms
- 95th percentile latency
- 1380 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1380 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http okkmax-mcp https://www.okkmax.com/mcpCodex
codex mcp add okkmax-mcp --url https://www.okkmax.com/mcpCursor
{
"mcpServers": {
"okkmax-mcp": {
"url": "https://www.okkmax.com/mcp"
}
}
}Cline
{
"mcpServers": {
"okkmax-mcp": {
"type": "streamableHttp",
"url": "https://www.okkmax.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"okkmax-mcp": {
"type": "http",
"url": "https://www.okkmax.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http okkmax-mcp https://www.okkmax.com/mcpClaude Desktop
https://www.okkmax.com/mcpWindsurf
{
"mcpServers": {
"okkmax-mcp": {
"serverUrl": "https://www.okkmax.com/mcp"
}
}
}Let your agent find its tools
Find servers like OkkMax MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other ai and machine learning servers
Do you run OkkMax MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.