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 46 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 --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 46-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 --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 published 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 release snapshot is generated from the authoritative live publisher

registry and rejected unless it contains exactly 46 unique App Store IDs × 50

Apple locales = 2,300 complete records. The runtime reads only that

digest-verified bundled snapshot: it makes no network request, and 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 latest

verified public GitHub release through `npx`; Node.js 20 or newer is required.

The same configuration can be added manually:

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

The MCPB uses Node's stdio transport and needs no account, API key, external UI

runtime, or manual configuration.

The source includes a multi-architecture OCI release path. Main does not

advertise an OCI tag as installable until release publication verifies an

existing public GHCR package, a candidate digest, ownership labels, SBOM,

provenance, and a 50-locale MCP smoke test, then promotes that same digest to

the public semver tag and Registry.

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 catalog:gate
npm run build:ui
npm run build:skill
npm test
npm run smoke
npm run benchmark
npm run validate
npm run validate:registry
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 MCPB and attested multi-architecture OCI image, then

update the official Registry through GitHub OIDC without long-lived registry

credentials. Registry publication is the final step and cannot run before all

artifact gates succeed.

Privacy

See PRIVACY.md. The runtime has zero telemetry, no analytics

or tracking, no network requests, and no query, IP-address, or user-agent

logging.

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.