{
  "markdown": "# Lumi App Finder MCP\n\nLumi App Finder gives AI assistants one read-only tool for matching a user's\ntask or buyer need to a verified live Lumi Studio iOS app.\n\nIt covers **46 apps × all 50 Apple locales**. Every result includes\neditorially localized context, the purchase model, a detailed guide, and a\ndirect App Store link for the matching storefront.\n\nHosts that support the stable MCP Apps extension render the matches as\ninteractive, localized cards with one-click App Store and guide actions.\nOther hosts receive the same complete text and structured-data fallback.\n\n> **First-party disclosure:** Lumi Studio develops every listed app. Results\n> are transparent publisher-authored text matches, not measured search volume,\n> independent rankings, reviews, or user endorsements.\n\n## Agent Skill\n\nAI hosts that support the open Agent Skills specification can install the same\n50-locale, first-party catalog as an offline, progressively loaded skill:\n\n```bash\ngh skill install alice51849/lumi-mcp lumi-app-finder --scope user\n```\n\nGitHub CLI 2.90 or newer installs to GitHub Copilot by default. Add\n`--agent claude-code`, `--agent cursor`, `--agent codex`, or\n`--agent gemini-cli` for another supported host. The installed skill reads only\nthe requested locale's 46-record snapshot and requires no account, API key,\nnetwork request, or executable script at runtime.\n\nThe version-pinned skill also works with the Vercel Skills CLI and its supported\nagents:\n\n```bash\nnpx -y skills@1.5.19 add https://github.com/alice51849/lumi-mcp --skill lumi-app-finder -g -y\n```\n\nThe third-party installer reports anonymous installation telemetry by default\nunder the [skills.sh CLI policy](https://skills.sh/docs/cli). The installed Lumi\nApp Finder skill itself remains offline and contains no analytics.\n\nThe public skill is discoverable on its\n[skills.sh directory page](https://www.skills.sh/alice51849/lumi-mcp/lumi-app-finder),\nwhich reads the same first-party `SKILL.md` from this repository.\n\nLumi App Finder is also listed in the independently maintained\n[Awesome Skills directory](https://github.com/intellectronica/awesome-skills/blob/main/skills.yaml),\nwhich links to the published skill files.\n\n## Tool\n\n### `find_ios_apps`\n\nInputs:\n\n- `query` — task, app name, or buyer need in any supported language.\n- `locale` — one of Apple's 50 supported locale codes; defaults to `en-US`.\n- `limit` — 1–10 matches; defaults to 5.\n\nThe release snapshot is generated from the authoritative live publisher\nregistry and rejected unless it contains exactly 46 unique App Store IDs × 50\nApple locales = 2,300 complete records. The runtime reads only that\ndigest-verified bundled snapshot: it makes no network request, and user query\ntext never leaves the local MCP process.\n\n## Install\n\nFind `io.github.alice51849/lumi-app-finder` in clients or registries that use\nthe official MCP Registry, or use a version-pinned installer:\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522lumi-app-finder%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522https%253A%252F%252Fgithub.com%252Falice51849%252Flumi-mcp%252Freleases%252Flatest%252Fdownload%252Flumi-app-finder-npx.tgz%2522%255D%257D)\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=lumi-app-finder&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImh0dHBzOi8vZ2l0aHViLmNvbS9hbGljZTUxODQ5L2x1bWktbWNwL3JlbGVhc2VzL2xhdGVzdC9kb3dubG9hZC9sdW1pLWFwcC1maW5kZXItbnB4LnRneiJdfQ%3D%3D)\n[![Download for Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Download_MCPB-D97757)](https://github.com/alice51849/lumi-mcp/releases/latest/download/lumi-app-finder.mcpb)\n\nThe VS Code and Cursor links run the zero-dependency server from the latest\nverified public GitHub release through `npx`; Node.js 20 or newer is required.\nThe same configuration can be added manually:\n\n```json\n{\n  \"servers\": {\n    \"lumi-app-finder\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"https://github.com/alice51849/lumi-mcp/releases/latest/download/lumi-app-finder-npx.tgz\"\n      ]\n    }\n  }\n}\n```\n\nThe MCPB uses Node's stdio transport and needs no account, API key, external UI\nruntime, or manual configuration.\n\nThe source includes a multi-architecture OCI release path. Main does not\nadvertise an OCI tag as installable until release publication verifies an\nexisting public GHCR package, a candidate digest, ownership labels, SBOM,\nprovenance, and a 50-locale MCP smoke test, then promotes that same digest to\nthe public semver tag and Registry.\n\nFor Cline, use the exact configuration and verification steps in\n[llms-install.md](https://github.com/alice51849/lumi-mcp/blob/main/llms-install.md).\n\n## 50-locale coverage\n\n`ar-SA`, `bn-BD`, `ca`, `cs`, `da`, `de-DE`, `el`, `en-AU`, `en-CA`,\n`en-GB`, `en-US`, `es-ES`, `es-MX`, `fi`, `fr-CA`, `fr-FR`, `gu-IN`, `he`,\n`hi`, `hr`, `hu`, `id`, `it`, `ja`, `kn-IN`, `ko`, `ml-IN`, `mr-IN`, `ms`,\n`nl-NL`, `no`, `or-IN`, `pa-IN`, `pl`, `pt-BR`, `pt-PT`, `ro`, `ru`, `sk`,\n`sl-SI`, `sv`, `ta-IN`, `te-IN`, `th`, `tr`, `uk`, `ur-PK`, `vi`,\n`zh-Hans`, `zh-Hant`.\n\nMCPB display metadata and the catalog output both use these localized\nresources.\n\n## Development\n\n```bash\nnpm ci\nnpm run catalog:gate\nnpm run build:ui\nnpm run build:skill\nnpm test\nnpm run smoke\nnpm run benchmark\nnpm run validate\nnpm run validate:registry\nnpm run pack:mcpb\n```\n\nRefresh the bundled catalog and 50 locale resources from the public\n`ios-app-guide` source:\n\n```bash\nnpm run sync:catalog\n```\n\nVersion tags publish the MCPB and attested multi-architecture OCI image, then\nupdate the official Registry through GitHub OIDC without long-lived registry\ncredentials. Registry publication is the final step and cannot run before all\nartifact gates succeed.\n\n## Privacy\n\nSee [PRIVACY.md](./PRIVACY.md). The runtime has zero telemetry, no analytics\nor tracking, no network requests, and no query, IP-address, or user-agent\nlogging.\n\n## Security\n\nReport vulnerabilities privately through the\n[security policy](./SECURITY.md), not through a public issue.\n\n## License\n\nMIT. Third-party language-data notices are in\n[THIRD_PARTY_NOTICES.txt](./THIRD_PARTY_NOTICES.txt); bundled MCP App library\nlicenses are in [MCP_APP_NOTICES.txt](./MCP_APP_NOTICES.txt).\n",
  "bytes": 6520,
  "sha": "074e8a1517f26048519e2564950d86da2895c0979050c48384cf8208a4e68f56",
  "repo_slug": "alice51849/lumi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_alice51849_lumi_app_finder_67b50612/readme"
}