Appdrift MCP Server

AppDrift MCP Server

Read your AppDrift keyword observations, account apps and action plan from Claude Desktop, Cursor or another MCP client. Generate or translate listing copy, review the result, and apply accepted fields to an editable AppDrift draft. These tools do not publish to Apple or Google.

This package is a small local stdio client for the AppDrift REST API. It requires Node.js 22 or later and an AppDrift API key. API access is available on eligible paid plans. Eligible first subscriptions have a seven-day trial with a card; the trial adds no tokens. Current plans and token allowances.

Install

Add AppDrift to your MCP client's configuration (Claude Desktop, Cursor or another MCP client):

{
  "mcpServers": {
    "appdrift": {
      "command": "npx",
      "args": ["-y", "appdrift-mcp"],
      "env": { "APPDRIFT_API_KEY": "ad_live_your_key_here" }
    }
  }
}

1. Create a key in the Developers dashboard.
2. Replace the placeholder in your client's local MCP configuration. Keep the key out of shared configuration and source control.
3. Restart the client. Ask it to call account_status, then list_apps. These calls consume no AI tokens.
4. Choose the returned app ID before asking for its tracked keywords. Review proposed text before allowing a paid action or a saved-draft change.

On the first run, npx downloads the package and its dependencies. If the client cannot find npx, use its absolute local executable path.

Without the npm registry: AppDrift also hosts the same wrapper as a versioned archive. Use https://appdrift.co/downloads/appdrift-mcp-0.2.0.tgz in args in place of appdrift-mcp, and check it against its SHA-256 checksum. The archive includes the complete wrapper source and MIT license. server.json prepares the official MCP registry entry, which is not published yet.

Tools and costs

No additional AI tokens: API access still requires an eligible account plan.

AI tools: AppDrift charges for successful processing. Check the returned token charge and account balance. The client never retries these actions automatically.

Paid operations and apply_optimization are advertised as writes to MCP clients. A timeout or lost response does not prove that the server stopped processing or charged nothing. Check the account and draft before retrying. The client sends your API key and supplied listing text to the configured AppDrift API; AI requests may use the account's configured AI provider.

The legacy keyword_difficulty tool is separate from the experimental Keyword analyzer. Its scores do not predict rank, traffic or download gains.

Configuration

The client rejects redirects, bounds response size, validates tool inputs before requests and returns authored error messages instead of provider errors or stack traces. These safeguards do not replace backend authorization or review of an agent's proposed actions.

Troubleshooting

• No tools: confirm Node 22+, npx availability and a nonempty APPDRIFT_API_KEY. MCP protocol messages use stdout; startup errors use stderr.
• Invalid or revoked key: create or select an active key in Developers and update the local config.
• Insufficient tokens: inspect account_status and current token options. A trial itself adds no tokens.
• No editable draft: create the app's draft in AppDrift, then apply only the fields you reviewed.
• No store results: try again later. A missing score is not zero competition.
• Timeout after a paid action: inspect balance and saved state before requesting the action again.

Development

Within a source checkout, run npm ci, npm test and npm run verify:package. Integration checks launch the actual stdio process against local fixture APIs; they do not use production credentials or spend tokens. Package verification packs only the declared runtime files, installs the archive through a local HTTP URL into a clean directory and runs the integration suite against the installed executable.

License

MIT. See LICENSE.