{"_id":"@ckz_2055/apptweak-mcp","_rev":"2-fc000d58dbba43d83ee09c48e170cea8","name":"@ckz_2055/apptweak-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@ckz_2055/apptweak-mcp","version":"1.0.0","keywords":["mcp","apptweak","aso","app-store","google-play"],"author":"","license":"MIT","_id":"@ckz_2055/apptweak-mcp@1.0.0","maintainers":[{"name":"ckz_2055","email":"ck@seeice.com"}],"bin":{"apptweak-mcp":"dist/index.js"},"dist":{"shasum":"d2ae0515f73b5284288ac69b4c13d43cb9085eba","tarball":"https://registry.npmjs.org/@ckz_2055/apptweak-mcp/-/apptweak-mcp-1.0.0.tgz","fileCount":34,"integrity":"sha512-osbDgFNS2wvjWQXEM1jAD9+6ZdeV0wuyND3z0TrQB+hlkIvTkX6i0llHLtg/ROFpiEy0Ug2X213K2LWzT64LQg==","signatures":[{"sig":"MEUCIQDo6FEDhLJHMpX/u/92h9Go2Gf3z77k0KTMdNscCo9zCwIgY8L0T0wDC7soJ3KBf3PbWtDAzE6Xr+js8inbvtLE7kI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88406},"jest":{"preset":"ts-jest","testMatch":["**/tests/**/*.test.ts"],"testEnvironment":"node"},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"9454f38ae26663475e1d476c5200653ed634e0a2","scripts":{"dev":"ts-node src/index.ts","test":"jest","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"ckz_2055","email":"ck@seeice.com"},"_npmVersion":"11.6.2","description":"MCP server for AppTweak API — exposes all 48 AppTweak tools for LLM clients","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.10.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.7","axios-mock-adapter":"^2.1.0"},"_npmOperationalInternal":{"tmp":"tmp/apptweak-mcp_1.0.0_1774739184698_0.20303040673614436","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ckz_2055/apptweak-mcp","version":"1.0.1","description":"MCP server for AppTweak API — exposes all 48 AppTweak tools for LLM clients","main":"./dist/index.js","bin":{"apptweak-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"ts-node src/index.ts","test":"jest","prepublishOnly":"npm run build"},"keywords":["mcp","apptweak","aso","app-store","google-play"],"author":"","license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.10.1","axios":"^1.7.9","zod":"^3.24.1"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^22.10.7","axios-mock-adapter":"^2.1.0","jest":"^29.7.0","ts-jest":"^29.2.5","typescript":"^5.7.3"},"jest":{"preset":"ts-jest","testEnvironment":"node","testMatch":["**/tests/**/*.test.ts"]},"gitHead":"14317725bb73504e9e108bb9b4bbaae37a190f92","types":"./dist/index.d.ts","_id":"@ckz_2055/apptweak-mcp@1.0.1","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-tzb6hTRwOQ77xhVd945MqNHzCR8tHLoshn4KCVtfmPxq+aNjUnCMYxkVtcY1z5aKR6IqpPvPZYtiAeLMi3YS9A==","shasum":"a36030fb68b2c9c7ab1991308477c8aaac3154fb","tarball":"https://registry.npmjs.org/@ckz_2055/apptweak-mcp/-/apptweak-mcp-1.0.1.tgz","fileCount":34,"unpackedSize":90894,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGdL/rITUKxhNnWrslzIaqKbme5/JRm7SuXaPnNgPwiDAiEA/xXs+7bCxKtGfBaVHZjs9FqL+ke8gPlJ5Og28KIWLZ4="}]},"_npmUser":{"name":"ckz_2055","email":"ck@seeice.com"},"directories":{},"maintainers":[{"name":"ckz_2055","email":"ck@seeice.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/apptweak-mcp_1.0.1_1774742673606_0.6528914406603517"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-28T23:06:24.522Z","modified":"2026-03-29T00:04:33.915Z","1.0.0":"2026-03-28T23:06:24.835Z","1.0.1":"2026-03-29T00:04:33.797Z"},"license":"MIT","keywords":["mcp","apptweak","aso","app-store","google-play"],"description":"MCP server for AppTweak API — exposes all 48 AppTweak tools for LLM clients","maintainers":[{"name":"ckz_2055","email":"ck@seeice.com"}],"readme":"# apptweak-mcp\n\nAn MCP (Model Context Protocol) server that exposes all AppTweak API endpoints as tools for LLM clients like Claude Desktop, Cursor, and others.\n\n## Features\n\n- **48 tools** covering all AppTweak API endpoints\n- App metadata, metrics, rankings, reviews, featured content, in-app events\n- Keyword metrics, live search, suggestions, ad intelligence (CPP)\n- Top charts, DNA charts, category benchmarks\n- Console data (App Store Connect, Google Play Console)\n- Utility endpoints (credits, countries, tracked apps CRUD)\n\n## Requirements\n\n- Node.js 18+\n- An [AppTweak API key](https://developers.apptweak.com)\n\n## Usage\n\nAdd to your MCP client config (e.g., `~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n### Via environment variable (recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"apptweak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"apptweak-mcp\"],\n      \"env\": {\n        \"APPTWEAK_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Via CLI argument\n\n```json\n{\n  \"mcpServers\": {\n    \"apptweak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"apptweak-mcp\", \"--api-key\", \"your-api-key-here\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### App Tools (18)\n| Tool | Description |\n|------|-------------|\n| `apptweak_app_metadata_current` | Current app metadata (title, description, ratings, etc.) |\n| `apptweak_app_metadata_history` | Historical metadata changes |\n| `apptweak_app_metrics_current` | Current downloads, revenues, app-power |\n| `apptweak_app_metrics_history` | Historical performance metrics |\n| `apptweak_app_category_ranking_current` | Current category chart position |\n| `apptweak_app_category_ranking_history` | Historical category ranking |\n| `apptweak_app_reviews_displayed` | Top displayed reviews |\n| `apptweak_app_reviews_search` | Search reviews by keyword/rating |\n| `apptweak_app_reviews_stats` | Aggregate review statistics |\n| `apptweak_featured_content` | App Store featured placements (iOS) |\n| `apptweak_in_app_events_list` | In-app events list (iOS) |\n| `apptweak_in_app_events_metadata` | In-app event details |\n| `apptweak_app_twin` | Find equivalent app on other platform |\n| `apptweak_cpp_by_app` | Custom Product Pages by app |\n| `apptweak_cpp_by_category` | CPPs by category |\n| `apptweak_cpp_by_dna` | CPPs by DNA classification |\n| `apptweak_cpp_by_keyword` | CPPs by keyword |\n| `apptweak_cpp_keywords` | Keywords triggering CPPs |\n\n### Keyword Tools (12)\n| Tool | Description |\n|------|-------------|\n| `apptweak_keyword_metrics_current` | Volume, difficulty, brand score |\n| `apptweak_keyword_metrics_history` | Historical keyword metrics |\n| `apptweak_keyword_rankings_by_app_current` | Keywords an app ranks for |\n| `apptweak_keyword_rankings_by_app_history` | Historical keyword rankings |\n| `apptweak_keyword_live_search_current` | Current search results for keyword |\n| `apptweak_keyword_live_search_ads_current` | Current ads for keyword |\n| `apptweak_keyword_live_search_history` | Historical SERP |\n| `apptweak_keyword_suggestions_by_app` | Keyword ideas from app installs |\n| `apptweak_keyword_suggestions_by_category` | Top keywords in category |\n| `apptweak_keyword_suggestions_trending` | Trending/discover keywords |\n| `apptweak_app_paid_keywords` | Keywords an app bids on |\n| `apptweak_keywords_share_of_voice` | Ad impression share by keyword |\n\n### Chart Tools (5)\n| Tool | Description |\n|------|-------------|\n| `apptweak_top_charts_current` | Current top free/paid/grossing chart |\n| `apptweak_top_charts_history` | Historical chart rankings |\n| `apptweak_dna_charts_current` | Top charts by DNA segment |\n| `apptweak_conversion_rate_benchmarks` | Category conversion benchmarks |\n| `apptweak_category_metrics` | Category-level aggregate metrics |\n\n### Console Tools (9)\n| Tool | Description |\n|------|-------------|\n| `apptweak_console_accounts` | List integrated developer accounts |\n| `apptweak_console_integrated_apps` | Apps from integrated accounts |\n| `apptweak_console_asc_by_device` | App Store Connect by device |\n| `apptweak_console_asc_by_channel` | App Store Connect by channel |\n| `apptweak_console_asc_by_in_app_event` | App Store Connect by in-app event |\n| `apptweak_console_gplay_store_performance` | Google Play store performance |\n| `apptweak_console_gplay_organic_search` | Google Play organic search |\n| `apptweak_console_gplay_reports` | Google Play statistics |\n| `apptweak_console_reply_to_review` | Reply to review (deprecated) |\n\n### Utility Tools (7)\n| Tool | Description |\n|------|-------------|\n| `apptweak_credits_balance` | API credits remaining |\n| `apptweak_countries` | Supported countries list |\n| `apptweak_languages` | Supported languages list |\n| `apptweak_dnas` | DNA classification list |\n| `apptweak_tracked_apps_create` | Add apps to tracking |\n| `apptweak_tracked_apps_list` | List tracked apps |\n| `apptweak_tracked_apps_update` | Update tracked app settings |\n| `apptweak_tracked_apps_delete` | Remove tracked apps |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}