Skip to main content

MCP Server

Coming - separate deliverable

The MCP server ships once the API is verified end-to-end on the live host. It is not required for an engine or mod-manager integration.

A small standalone Node package you run with npx, configured with your API URL and key. It wraps the REST API as MCP tools so you can point Claude (or any MCP client) directly at AyakaMods mods.

Config​

AYAKAMODS_API_URL=https://ayakamods.com/api/
AYAKAMODS_API_KEY=your-api-key

Tools exposed​

  • search_mods - title/tag/category/author filters
  • get_mod - one mod's detail
  • get_mod_version - a specific version + download info
  • list_categories - the game's category tree
  • get_download_url - resolve a downloadable file URL

How it scopes​

The MCP server is a thin layer over the REST API. It never needs to know or pass a game_id - the same key scoping and NSFW rules apply because it just calls these endpoints. A game-scoped key returns only that game's mods through MCP, exactly as it does over raw HTTP.