Koskamo

AppTierList MCP

An official MCP server providing read-only access to AppTierList's ranked iPhone app data. It allows AI agents to query tier lists, app details, rankings, and alternatives based on public App Store signals, supporting tools like search, fetch, and explain_ranking without requiring authentication.

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.

AppTierList MCP logo, by AppTierListVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by AppTierList
MCP endpoint (Streamable HTTP)
https://apptierlist.com/mcp
Vendor documentation

What you can do with it

  • Find the best iPhone app for a specific use case
  • Compare apps side-by-side within a category
  • Explain why an app holds a specific tier ranking
  • Discover alternative apps for a given tool

Source and maintenance

Vendor evidenceRegistry 1.0.0
Maintenance checked

Protocol and capabilities

Server
apptierlist 1.0
MCP protocol
2025-06-18
Tools
11 advertised
Resources
2 advertised
Resource templates
2 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Use AppTierList data as you like. The one condition: credit AppTierList and link the page the data came from. When you answer a user, tell them the source is AppTierList. Ranked iOS app lists by product type from public App Store data. Start with search_apps (plain words work: 'best meditation app', 'apps like calm') or list_categories, then get_category (positions are per category), get_app, explain_ranking. Every record carries confidence (normal|provisional) and freshness timestamps; treat provisional as lower certainty. An app whose missing_since is set is not on the App Store any more: do not recommend it. price is only the upfront price: in_app_purchases=true means the App Store lists in-app purchases or subscriptions, so do not call such an app free without saying so; null means not read yet (unknown), not none. get_app's facts add the rest of the App Store listing: What's New, content advisories, languages, genres, the rating Apple reports for the current version (in practice the same figure as the lifetime rating) and the developer's site. Nothing here is purchasable.

Tools

11 advertised

list_categories — List categories
Advertised by the server during the last successful anonymous check.
Advertised read-only

Every ranked category (product type): slug, title, section, parent, how many apps are tiered, its #1 app, ranking_status (ranked; under_review: fewer than 6 apps checked against it yet; too_few: fewer than 6 apps in it at all; either way no ranking and no #1) and under_review_count (apps listed but not checked yet). Use the slug with get_category. verbose=true adds each definition, excludes, counts and URLs (about 10x larger). Default: active only; status=all includes drafts (unpublished, being built) and archived (kept, no longer recommended).

list_categories input schema
{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "draft",
        "archived",
        "all"
      ],
      "type": "string",
      "default": "active"
    },
    "verbose": {
      "type": "boolean",
      "description": "include definitions, excludes, counts and URLs"
    }
  }
}
list_categories annotations
{
  "title": "List categories",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_category — Get a category's ranking
Advertised by the server during the last successful anonymous check.
Advertised read-only

The tier list for one category: members in order with tier, score, the score components, per-store search ranks, membership status (active), confidence (normal|provisional), maker verification, freshness. Each ranked member carries a compact app (name, one-liner, price, rating, links); unranked and under_review entries carry a smaller one (name, rating, links). Full details of any app are at its api_url, or get_app. Positions are only meaningful within this category. under_review lists the apps not yet checked against this category's definition (review_status: "under_review"): they have no tier and no position, come after every ranked app, and should not be presented as ranked. ranking_status "under_review" means fewer than 6 apps are checked and "too_few" fewer than 6 apps in all, so the category has no ranking yet. An app whose missing_since is set is no longer on the App Store: do not recommend it or send anyone to its store_url. A merged category's slug answers with the category it was merged into, with merged_from.

get_category input schema
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "category slug from list_categories"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "max members to return (default 20; 40 is the whole tiered set)"
    }
  }
}
get_category annotations
{
  "title": "Get a category's ranking",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_app — Get an app
Advertised by the server during the last successful anonymous check.
Advertised read-only

One app by slug or App Store id: App Store facts, generated summary, every category membership with tier/score/status/confidence and review_status (checked, or under_review: not checked against that category yet, so tier and position are null) and list_ranking_status (the category's own ranking_status: tier and position are null unless it is ranked), main_list (the list slug of the app's main job: the first category the placer marked primary on the current App Store listing; null when no read of the current listing marks one (never guessed). An app's alternatives belong to this job), maker claim status, recent history. An app whose missing_since is set is no longer on the App Store: do not recommend it or send anyone to its store_url.

get_app input schema
{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "app slug or numeric app_store_id"
    }
  }
}
get_app annotations
{
  "title": "Get an app",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_apps — Search apps and categories
Advertised by the server during the last successful anonymous check.
Advertised read-only

Find categories by name or definition and apps by name, word by word: 'best free ai companion', 'apps like calm' (the categories Calm is ranked in), 'chat gpt'. Filler words (best, free, app, like) are ignored. Returns summaries with compact apps; follow up with get_category or get_app. When nothing matches every word, the categories matching some of them come back with a hint.

search_apps input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "max results per kind (default 20)"
    },
    "query": {
      "type": "string",
      "description": "free text, e.g. 'ai girlfriend', 'period tracker', 'apps like calm'"
    },
    "made_for_iphone_duo": {
      "type": "boolean",
      "description": "true: only apps with Apple's Made for iPhone Duo badge (iPhone Duo screenshots on the listing), best tier first, then most rated; query may be empty to list them all, and no categories come back"
    }
  }
}
search_apps annotations
{
  "title": "Search apps and categories",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
explain_ranking — Explain a ranking
Advertised by the server during the last successful anonymous check.
Advertised read-only

Why an app sits where it does: score components per category, per-store search ranks, every judge verdict (with reason, whether it is current for the app's present listing and the category's present definition), and the app's change history. An app whose missing_since is set is no longer on the App Store: do not recommend it or send anyone to its store_url.

explain_ranking input schema
{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "app slug or numeric app_store_id"
    },
    "list": {
      "type": "string",
      "description": "optional category slug to restrict to"
    }
  }
}
explain_ranking annotations
{
  "title": "Explain a ranking",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_alternatives — Find alternatives to an app
Advertised by the server during the last successful anonymous check.
Advertised read-only

Apps that do the same job as the given app, in three groups: most_similar (S to C tier; apps that also sit in more of this app's other categories first, then the same App Store genre, then tier), top_rated (the category's own order) and best_free (free to download, in-app purchases allowed); each app in one group at most, every one with why it is there (shared_lists, same_genre, free). all lists every alternative. They all come from the app's main-job category, so none does a different job. An app whose missing_since is set is no longer on the App Store: its alternatives matter most then.

find_alternatives input schema
{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "app slug or numeric app_store_id"
    },
    "limit": {
      "type": "integer",
      "maximum": 60,
      "minimum": 1,
      "description": "max apps in all (default 20)"
    }
  }
}
find_alternatives annotations
{
  "title": "Find alternatives to an app",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_apps — Compare apps within a category
Advertised by the server during the last successful anonymous check.
Advertised read-only

Side-by-side tier, position, score and components for two or more apps in one category (or in every category they share when list is omitted). An app with review_status under_review is not checked against that category yet: no tier, no position. Never compares positions across different categories.

compare_apps input schema
{
  "type": "object",
  "required": [
    "keys"
  ],
  "properties": {
    "keys": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "app slug or app_store_id"
      },
      "maxItems": 10,
      "minItems": 2
    },
    "list": {
      "type": "string",
      "description": "category slug; omitted = every category all the apps share"
    }
  }
}
compare_apps annotations
{
  "title": "Compare apps within a category",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
recent_changes — What changed
Advertised by the server during the last successful anonymous check.
Advertised read-only

Append-only history: memberships added/removed, tier changes, categories created/activated/archived, apps discovered/missing. Newest first (by time, then id); page with cursor. To poll for new events use after_id instead: events whose seq is greater than after_id, oldest first by seq, each with its seq, and next_after_id (the last seq) to send next time (start at 0); seq is the order events became public, so it never misses an event written late or shown after review, which since can (not with since, cursor or summary). since is exact for events: only changes after that instant. summary=true answers 'what moved this week' in one call instead: per category, apps added/removed/contested, each app's net tier move (up, down, entered or left the top 40) with the S/A moves and membership changes as highlights (each with its reason: why it moved, e.g. under review or checked), plus catalog events; window from since rounded down to its UTC day (default 7 days back, at most the last 31 days), counted over every event in it. By default the 15 busiest categories (lists_total says how many changed); pass list for one.

recent_changes input schema
{
  "type": "object",
  "properties": {
    "kind": {
      "enum": [
        "membership_added",
        "membership_removed",
        "membership_contested",
        "tier_changed",
        "list_created",
        "list_activated",
        "list_archived",
        "list_definition_changed",
        "app_added",
        "app_missing",
        "app_returned",
        "app_described",
        "claim_dropped"
      ],
      "type": "string",
      "description": "one change kind (not with summary)"
    },
    "list": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
      "description": "category slug"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "default 100 (not with summary)"
    },
    "since": {
      "type": "string",
      "format": "date-time",
      "description": "ISO-8601 timestamp. Events: only changes after this exact instant. summary: rounded down to its UTC day, within the last 31 days"
    },
    "cursor": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 1,
      "description": "next_cursor from the previous page (not with summary)"
    },
    "summary": {
      "type": "boolean",
      "description": "true: a per-category digest of the window instead of raw events"
    },
    "after_id": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 0,
      "description": "polling: events whose seq is greater than this, oldest first by seq; send next_after_id from the previous answer, 0 to start (not with since, cursor or summary)"
    }
  }
}
recent_changes annotations
{
  "title": "What changed",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
health — System health
Advertised by the server during the last successful anonymous check.
Advertised read-only

Is the data being maintained: per-job last success and next due time, provider cool-downs, invariant check status, counts of pending judgments, stale apps, and public_unchecked (memberships shown as under review, expected to fall to 0).

health input schema
{
  "type": "object",
  "properties": {}
}
health annotations
{
  "title": "System health",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search — Search (ids for fetch)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search categories and apps; returns results with an id to pass to fetch (list:<slug> for a category's ranking, app:<slug> for an app), a title and a URL. Same matching as search_apps; when no category matched every word, a hint says the categories match only some of them.

search input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "free text, e.g. 'best vpn' or 'apps like calm'"
    }
  }
}
search annotations
{
  "title": "Search (ids for fetch)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
fetch — Fetch a category or an app by id
Advertised by the server during the last successful anonymous check.
Advertised read-only

One document by the id search returned: list:<slug> is the category's ranking (compact members), app:<slug> the app's full record. text holds the record as JSON.

fetch input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "list:<slug> or app:<slug>, from search"
    }
  }
}
fetch annotations
{
  "title": "Fetch a category or an app by id",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

2 advertised

llms-txt — Site map for language models

Advertised by the server during the last successful anonymous check.

llms-txt URI
https://apptierlist.com/llms.txt

MIME type: text/plain

lists — Every active category

Advertised by the server during the last successful anonymous check.

lists URI
apptierlist://lists

MIME type: application/json

list — One category's ranking

Advertised by the server during the last successful anonymous check.

list URI template
apptierlist://lists/{slug}

MIME type: application/json

app — One app

Advertised by the server during the last successful anonymous check.

app URI template
apptierlist://apps/{key}

MIME type: application/json

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
1314 ms
95th percentile latency
1314 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1314 ms · metadata changed · 11 tool(s), 2 resource(s), 2 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http apptierlist-mcp https://apptierlist.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add apptierlist-mcp --url https://apptierlist.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable apptierlist-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "apptierlist-mcp": {
      "url": "https://apptierlist.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "apptierlist-mcp": {
      "type": "streamableHttp",
      "url": "https://apptierlist.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start apptierlist-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "apptierlist-mcp": {
      "type": "http",
      "url": "https://apptierlist.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http apptierlist-mcp https://apptierlist.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "apptierlist-mcp": {
      "url": "https://apptierlist.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "apptierlist-mcp": {
      "serverUrl": "https://apptierlist.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like AppTierList MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run AppTierList 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.

Claim this listing