{"_id":"@appranks.app/mcp-server","_rev":"4-129b73886cee63802096f04cd151c22d","name":"@appranks.app/mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@appranks.app/mcp-server","version":"1.0.0","keywords":["mcp","app-store","rankings","charts","ios","apple","iphone","ipad","mac","appranks"],"author":{"name":"AppRanks","email":"hello@appranks.app"},"license":"MIT","_id":"@appranks.app/mcp-server@1.0.0","maintainers":[{"name":"appranks","email":"appranks@mediaware.sk"}],"homepage":"https://github.com/kanzelsberger/AppRanks#readme","bugs":{"url":"https://github.com/kanzelsberger/AppRanks/issues"},"bin":{"mcp-server-appranks":"index.js"},"dist":{"shasum":"81b4b2a0739ca3de8279183355797600119692cc","tarball":"https://registry.npmjs.org/@appranks.app/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":3,"integrity":"sha512-wiyhGfFeO9u/pSD4cwh/Rfm6LswKpLRwoxFWlSZfYbyErlCfRKKEYW7wQdDErV3dY45Qc9jTW/GEdgNllZsq2w==","signatures":[{"sig":"MEUCIDkrn2HqiKJ+zZeSqzCLzhDkVaDH8Fj+xKL/GqfARytrAiEA7yBjbwrD5+8jbMFSBY24JvjSSGVApH/qYaP7KaPX3T4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10520},"main":"index.js","type":"module","gitHead":"439b6ce025110e72ee97a6c0b8165917709d09a5","scripts":{"start":"node index.js"},"_npmUser":{"name":"appranks","email":"appranks@mediaware.sk"},"repository":{"url":"git+https://github.com/kanzelsberger/AppRanks.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for live App Store rankings data — browse charts, search apps, view rankings across 55 countries","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1776081139182_0.0901732389437504","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@appranks.app/mcp-server","version":"1.0.1","keywords":["mcp","app-store","rankings","charts","ios","apple","iphone","ipad","mac","appranks"],"author":{"name":"AppRanks","email":"hello@appranks.app"},"license":"MIT","_id":"@appranks.app/mcp-server@1.0.1","maintainers":[{"name":"appranks","email":"appranks@mediaware.sk"}],"homepage":"https://github.com/kanzelsberger/AppRanks#readme","bugs":{"url":"https://github.com/kanzelsberger/AppRanks/issues"},"bin":{"mcp-server-appranks":"index.js"},"dist":{"shasum":"66f3eda3a9c0b90461b420e2bf5031c5218f60bd","tarball":"https://registry.npmjs.org/@appranks.app/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":3,"integrity":"sha512-rXjvE+iHRCnfv3PAx1GWKRUWgfI6f/1CC8mQGv7fB4YJBh3FrWsmbqpXHpWZqbk/mq80Q0enQeT05MKSvR/ouA==","signatures":[{"sig":"MEUCIQCnp0SLQdkzjJecsmJ1agH85pd/6i1gPJyMN2iQtD6PNQIgPQIoWvm1YHw1U5g7ybvQzx9rZ6pXrN9AH/ZoxoduLp4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10632},"main":"index.js","type":"module","gitHead":"f887261f55d29cef85222736a47776cfcb1aafef","scripts":{"start":"node index.js"},"_npmUser":{"name":"appranks","email":"appranks@mediaware.sk"},"repository":{"url":"git+https://github.com/kanzelsberger/AppRanks.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for live App Store rankings data — browse charts, search apps, view rankings across 55 countries","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1776086586585_0.7477695381543426","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@appranks.app/mcp-server","version":"1.0.2","keywords":["mcp","app-store","rankings","charts","ios","apple","iphone","ipad","mac","appranks"],"author":{"name":"AppRanks","email":"hello@appranks.app"},"license":"MIT","_id":"@appranks.app/mcp-server@1.0.2","maintainers":[{"name":"appranks","email":"appranks@mediaware.sk"}],"homepage":"https://github.com/kanzelsberger/AppRanks#readme","bugs":{"url":"https://github.com/kanzelsberger/AppRanks/issues"},"bin":{"mcp-server-appranks":"index.js"},"dist":{"shasum":"d926de2611190ee972d29f9ce00e3563dc03e204","tarball":"https://registry.npmjs.org/@appranks.app/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":3,"integrity":"sha512-1qR9gMYiJzCYAgTMgr5Cw59QnXsBA0iKaTCx+4oFMY9dYzVFQYjjy2lFxl1q8yW1UghGzExm3xJRisarNpJWPQ==","signatures":[{"sig":"MEYCIQCkJA9QCSdof58CHjq3yIIS+eR3kL/72tvza5CAuVzhdgIhAM8x7KTCg7iXgrTIpGVpYaMxiR1cmLo9jMyTOgFO0OM2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10730},"main":"index.js","type":"module","gitHead":"aedcc8cd8dbdd7b76c15f36b4dd95b2dfb6a33bf","scripts":{"start":"node index.js"},"_npmUser":{"name":"appranks","email":"appranks@mediaware.sk"},"repository":{"url":"git+https://github.com/kanzelsberger/AppRanks.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for live App Store rankings data — browse charts, search apps, view rankings across 55 countries","directories":{},"_nodeVersion":"22.22.2","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.2_1776087018602_0.15507900857498513","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@appranks.app/mcp-server","version":"1.0.3","description":"MCP server for live App Store rankings data — browse charts, search apps, view rankings across 55 countries","main":"index.js","bin":{"mcp-server-appranks":"index.js"},"type":"module","scripts":{"start":"node index.js"},"keywords":["mcp","app-store","rankings","charts","ios","apple","iphone","ipad","mac","appranks"],"author":{"name":"AppRanks","email":"hello@appranks.app"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/kanzelsberger/AppRanks.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_id":"@appranks.app/mcp-server@1.0.3","gitHead":"496ee594ae1d8b1593b979c0fdb4ab2997a98e2d","bugs":{"url":"https://github.com/kanzelsberger/AppRanks/issues"},"homepage":"https://github.com/kanzelsberger/AppRanks#readme","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-Ua8txZL8z9HaTE4K2VWxqWHwMiCiPAcy62hePlSK2KwJ2TynJFqPQdUvK1u16Ilb1uVO31qtzm+D9JOiphlEug==","shasum":"a6ca24ebf5c68402282679f3b0bd675a61260d19","tarball":"https://registry.npmjs.org/@appranks.app/mcp-server/-/mcp-server-1.0.3.tgz","fileCount":3,"unpackedSize":11204,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCJ7NFyH/F8Gd7PdvA6C9xS+M9uFBVt0wEsI6fO/GpC5QIgLwe75maSO0KYmr2b/BhskVqUXEK3u7qFM/NotEFkIJ0="}]},"_npmUser":{"name":"appranks","email":"appranks@mediaware.sk"},"directories":{},"maintainers":[{"name":"appranks","email":"appranks@mediaware.sk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.3_1777633644144_0.00038547310956893455"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T11:52:19.106Z","modified":"2026-05-01T11:07:24.425Z","1.0.0":"2026-04-13T11:52:19.306Z","1.0.1":"2026-04-13T13:23:06.725Z","1.0.2":"2026-04-13T13:30:18.774Z","1.0.3":"2026-05-01T11:07:24.276Z"},"bugs":{"url":"https://github.com/kanzelsberger/AppRanks/issues"},"author":{"name":"AppRanks","email":"hello@appranks.app"},"license":"MIT","homepage":"https://github.com/kanzelsberger/AppRanks#readme","keywords":["mcp","app-store","rankings","charts","ios","apple","iphone","ipad","mac","appranks"],"repository":{"type":"git","url":"git+https://github.com/kanzelsberger/AppRanks.git"},"description":"MCP server for live App Store rankings data — browse charts, search apps, view rankings across 55 countries","maintainers":[{"name":"appranks","email":"appranks@mediaware.sk"}],"readme":"# AppRanks MCP Server\n\nAn MCP (Model Context Protocol) server that provides live App Store rankings data from [AppRanks.app](https://appranks.app).\n\nBrowse charts, search apps, view rankings, read reviews — all from your AI assistant.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_chart` | Browse App Store charts (top free, paid, grossing) by country, platform, category |\n| `search_apps` | Search apps by name or developer |\n| `get_app` | Get app details with current rankings across all countries |\n| `get_rank_history` | View ranking history over time |\n| `get_reviews` | Read App Store reviews by country |\n| `list_countries` | List all 55 supported countries |\n| `list_categories` | List all App Store categories with IDs |\n\n## Coverage\n\n- **55 countries** across Americas, Europe, Middle East, Africa, and Asia Pacific\n- **4 platforms**: iPhone, iPad, Mac, Apple TV\n- **43 categories** including game subcategories\n- **3 chart types**: Top Free, Top Paid, Top Grossing\n- Updated every 4 hours\n\n## Setup\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"appranks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@appranks.app/mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add appranks -- npx -y @appranks.app/mcp-server\n```\n\n### Manual\n\n```bash\nnpx @appranks.app/mcp-server\n```\n\n## Examples\n\nAsk your AI assistant:\n\n- \"What are the top 10 free iPhone apps in Japan?\"\n- \"Search for weather apps\"\n- \"Show me Netflix's rankings across all countries\"\n- \"What's the ranking history for Spotify in the US over the last 30 days?\"\n- \"Show me 1-star reviews for TikTok in Germany\"\n\n## Configuration\n\n| Environment Variable | Default | Description |\n|---------------------|---------|-------------|\n| `APPRANKS_API_URL` | `https://appranks.app/api/v1` | API base URL |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}