Search ARK: Survival Ascended mods
search_modsSearch CurseForge's catalog for ARK: Survival Ascended mods by name, slug, category, or game version, with pagination and exclusion filters to narrow results.
Instructions
Search the CurseForge catalog for ARK: Survival Ascended mods. The gameId is resolved at runtime from GET /v1/games and is not a parameter — a wrong gameId returns a clean, empty, wrong result set rather than an error. Page size is capped at 50 by CurseForge and an over-large request is REFUSED rather than clamped, so that a page is never mistaken for a complete set. Every result states its pagination and whether more results exist, and says so explicitly when the tail of the result set is beyond the API's addressable window. class_id, category_id, and category_ids are include filters sent to CurseForge (discover ids via list_categories). exclude_category_ids is applied locally after the page returns — CurseForge has no exclude parameter — so pagination still describes the unfiltered upstream page. A hit is a catalog row, not an install: inspect file_name and file_length_bytes, then hand curseforge_mod_ids to nitrado-ark-mcp. Read-only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Exact mod slug, when you already know it. | |
| index | No | Zero-based result offset. index + page_size must not exceed 10000. | |
| class_id | No | Include: CurseForge section/class id. Discover via list_categories (is_class true). | |
| page_size | No | Results per page, at most 50. Over that is refused, not clamped. | |
| sort_field | No | CurseForge sort field, an integer 1-12 (documented range; the per-value meanings are not). | |
| sort_order | No | Sort direction. | |
| category_id | No | Include: a single category id. Do not also pass category_ids. | |
| category_ids | No | Include: up to 10 category ids. Overrides category_id at the vendor; this server refuses both at once rather than letting one silently win. | |
| game_version | No | Filter to files supporting this game version string. UNVERIFIED: whether ASA mods populate game version fields at all is ADR-002 §14.3 U9. | |
| search_filter | No | Free-text search term, matched by CurseForge against mod names. | |
| exclude_category_ids | No | LOCAL exclude after the page returns. CurseForge cannot exclude. Pagination still describes the unfiltered upstream page. For gameplay-only, list_categories then pass Custom Cosmetics' id. |