Lumi App Finder MCP

Lumi App Finder gives AI assistants one read-only tool for matching a user's task or buyer need to a verified live Lumi Studio iOS app.

It covers 29 apps × all 50 Apple locales. Every result includes editorially localized context, the purchase model, a detailed guide, and a direct App Store link for the matching storefront.

Hosts that support the stable MCP Apps extension render the matches as interactive, localized cards with one-click App Store and guide actions. Other hosts receive the same complete text and structured-data fallback.

First-party disclosure: Lumi Studio develops every listed app. Results are transparent publisher-authored text matches, not measured search volume, independent rankings, reviews, or user endorsements.

Agent Skill

AI hosts that support the open Agent Skills specification can install the same 50-locale, first-party catalog as an offline, progressively loaded skill:

gh skill install alice51849/lumi-mcp lumi-app-finder@v1.1.3 --scope user

GitHub CLI 2.90 or newer installs to GitHub Copilot by default. Add --agent claude-code, --agent cursor, --agent codex, or --agent gemini-cli for another supported host. The installed skill reads only the requested locale's 29-record snapshot and requires no account, API key, network request, or executable script at runtime.

The version-pinned skill also works with the Vercel Skills CLI and its supported agents:

npx -y skills@1.5.19 add https://github.com/alice51849/lumi-mcp/tree/v1.1.3/skills/lumi-app-finder --skill lumi-app-finder -g -y

The third-party installer reports anonymous installation telemetry by default under the skills.sh CLI policy. The installed Lumi App Finder skill itself remains offline and contains no analytics.

The public skill is discoverable on its skills.sh directory page, which reads the same first-party SKILL.md from this repository.

Lumi App Finder is also listed in the independently maintained Awesome Skills directory, which links to the immutable v1.1.3 skill files.

Tool

find_ios_apps

Inputs:

• query — task, app name, or buyer need in any supported language.
• locale — one of Apple's 50 supported locale codes; defaults to en-US.
• limit — 1–10 matches; defaults to 5.

The server reads the current public catalog when online and falls back to the bundled 1,450-record snapshot. User query text never leaves the local MCP process.

Install

Find io.github.alice51849/lumi-app-finder in clients or registries that use the official MCP Registry, or use a version-pinned installer:

The VS Code and Cursor links run the zero-dependency server from the pinned public v1.1.3 GitHub release through npx; Node.js 20 or newer is required. The same pinned configuration can be added manually:

{
  "servers": {
    "lumi-app-finder": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alice51849/lumi-mcp/releases/download/v1.1.3/lumi-app-finder-npx.tgz"
      ]
    }
  }
}

The MCPB uses Node's stdio transport and needs no account, API key, external UI runtime, or manual configuration.

For Cline, use the exact configuration and verification steps in llms-install.md.

50-locale coverage

ar-SA, bn-BD, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US, es-ES, es-MX, fi, fr-CA, fr-FR, gu-IN, he, hi, hr, hu, id, it, ja, kn-IN, ko, ml-IN, mr-IN, ms, nl-NL, no, or-IN, pa-IN, pl, pt-BR, pt-PT, ro, ru, sk, sl-SI, sv, ta-IN, te-IN, th, tr, uk, ur-PK, vi, zh-Hans, zh-Hant.

MCPB display metadata and the catalog output both use these localized resources.

Development

npm ci
npm run build:ui
npm run build:skill
npm test
npm run validate
npm run pack:mcpb

Refresh the bundled catalog and 50 locale resources from the public ios-app-guide source:

npm run sync:catalog

Version tags publish the bundle as a GitHub release and register it through GitHub OIDC, without long-lived registry credentials.

Privacy

See PRIVACY.md. The tool has no analytics or tracking, and never sends user queries to the catalog host.

Security

Report vulnerabilities privately through the security policy, not through a public issue.

License

MIT. Third-party language-data notices are in THIRD_PARTY_NOTICES.txt; bundled MCP App library licenses are in MCP_APP_NOTICES.txt.