Official AppTweak MCP integrations for Cursor, Claude Code, and Codex.
Install this and your AI coding assistant can query AppTweak — the app store intelligence and App Store Optimization (ASO) platform — directly from your editor: keyword rankings and search volume, app metadata and category rankings, download and revenue estimates, ratings and reviews, and competitive intelligence across the Apple App Store and Google Play. Ask your agent a question in plain language and it pulls live data from the AppTweak API, then helps you turn it into dashboards, reports, and extraction scripts.
This repository packages the plugins and setup tooling for each supported client. It uses the Model Context Protocol (MCP), an open standard for connecting AI assistants to external tools and data.
- Get your API key from your AppTweak account — see Get your API key.
- Pick your client and run the setup script or install the plugin.
- Restart your AI tool.
- Confirm the
apptweak-apiMCP server appears in your client.
# Example: Cursor on Linux/macOS
APPTWEAK_API_KEY=your-key ./clients/cursor/setup-apptweak-mcp.sh| Topic | Guide |
|---|---|
| Get your API key | docs/readme/get-api-key.md |
| Cursor | docs/readme/cursor.md |
| Claude Code | docs/readme/claude-code.md |
| Codex | docs/readme/codex.md |
| Troubleshooting | docs/readme/troubleshooting.md |
Full API reference: developers.apptweak.com.
plugins/ Official plugin packages (Cursor, Claude Code, Codex)
clients/ Manual setup scripts and config examples
shared/spec/ Canonical MCP server config
docs/readme/ Setup and usage documentation
| Client | Plugin path | Marketplace |
|---|---|---|
| Cursor | plugins/cursor |
.cursor-plugin/marketplace.json |
| Claude Code | plugins/claude-code |
Claude plugin marketplace (when published) |
| Codex | plugins/codex |
.agents/plugins/marketplace.json |
- Bring Your Own Key (BYOK): each user supplies their own
APPTWEAK_API_KEY. - Sent as the HTTP header
X-Apptweak-Keyvianpx mcp-remote. - Canonical config lives in
shared/spec/mcp-server.json.
- Troubleshooting: docs/readme/troubleshooting.md
- Issues: GitHub Issues on this repository
Released under the GNU General Public License v3.0.