MCP server
The AppGoat MCP server gives your agent app store tools: look up apps, read reviews and listing changes, research keywords and read the charts. Hosted at https://api.appgoat.ai/mcp (Streamable HTTP, OAuth sign-in or an x-api-key header).
Claude Code
Add the hosted server, then run /mcp in Claude Code and sign in with your AppGoat account.
claude mcp add --transport http appgoat https://api.appgoat.ai/mcpOr authenticate with an API key instead of OAuth:
claude mcp add --transport http appgoat https://api.appgoat.ai/mcp \
--header "x-api-key: $APPGOAT_API_KEY"Claude
On claude.ai or Claude Desktop open Settings → Connectors → Add custom connector, paste https://api.appgoat.ai/mcp and sign in.
Claude Desktop can also run the server locally (claude_desktop_config.json):
{
"mcpServers": {
"appgoat": {
"command": "npx",
"args": [
"-y",
"@appgoat/mcp"
],
"env": {
"APPGOAT_API_KEY": "your_api_key"
}
}
}
}Cursor
Add the server to .cursor/mcp.json in your project (or the global config). Cursor opens the sign-in page on first use.
{
"mcpServers": {
"appgoat": {
"url": "https://api.appgoat.ai/mcp"
}
}
}ChatGPT
Turn on developer mode (Settings → Apps & Connectors → Advanced), create a connector with the URL https://api.appgoat.ai/mcp and sign in with your AppGoat account.
Other clients
Any MCP client that speaks Streamable HTTP can use https://api.appgoat.ai/mcp (OAuth 2.1, or an x-api-key header). For stdio clients run the server locally with APPGOAT_API_KEY set:
APPGOAT_API_KEY=your_api_key npx -y @appgoat/mcpTools
Tool inputs are generated from the same OpenAPI document as the API reference. Results are compact markdown with a footer showing the credits used and left; pass format: "json" to get the raw { data, meta } response.
| Tool | What it does | Credits |
|---|---|---|
get_app | One app from any id, bundle id, package, store URL or name: metadata, ratings, version, description and the same app in the other store. include adds markets, versions, IAP, privacy, estimates and chart positions. | 1+ credits |
get_reviews | Reviews, newest first, with star, version, date, text and AI-tag filters (intent=bug,crash). | 1+ credits |
get_app_history | Daily rating, ratings, installs, histogram and price history, with the change over the period. | 1 credit |
get_app_changes | Listing change feed (title, subtitle, screenshots, price, version, …) with old and new values. | 1 credit |
get_app_keywords | Search terms the app ranks for, with popularity and difficulty. | 1 credit |
get_competitors | Competitors from shared keywords and the store's similar apps. | 1 credit |
search_apps | Find apps by name or id across both stores. | 1 credit |
get_charts | Top free, paid or grossing chart, today or on a past date, with moves and drop-outs. | 1 credit |
keyword_research | Popularity, difficulty, results and #1 downloads for up to 25 terms; related terms, autocomplete, top apps; an app's rank and relevance per term. | 1+ credits |
track_keywords | Start daily rank tracking (uses plan keyword slots). | Free |
untrack_keywords | Stop tracking keywords and free their slots. | Free |
list_tracked_keywords | Your tracked keywords with their latest top 10. | Free |
get_keyword_ranks | Ranking history of a tracked term, or one app's rank over time. | 1 credit |
get_developer | Developer profile, all their apps and the same company in the other store (contacts on Studio). | 1 credit |
get_job | Poll a background store fetch. | Free |
get_insights | What users praise and complain about, from AI-tagged reviews: top issues with 30-day trends and samples, per-version changes, weekly sentiment. | 25 credits |
watch | Watch an app, a set of competitors or keywords; significant changes become events. With id, change or pause a watch. | Free |
list_watches | Your watches with their apps, terms and event types, and usage against the plan's limits. | Free |
unwatch | Stop watches and free their apps and keyword slots. | Free |
get_events | Significant changes on your watched apps and keywords (new versions, metadata, price, rating drops, rank moves), newest first. | Free |
list_playbooks | The AppGoat playbooks (also served as MCP prompts). | Free |
Playbooks as prompts
The server bundles the AppGoat playbooks as MCP prompts, so clients that show prompts can run them as slash commands: app-audit-lite, find-app-ideas, aso-keywords-metadata-rewrite, competitor-digest, reviews-to-github-issues, reply-to-every-review, apple-ads-optimizer, localization-push. Clients without prompt support get the same text from the list_playbooks tool.
Errors and retries
Failed calls come back as a tool result with isError and a readable message: the HTTP status, the error code, the API's hint and a docs link. Rate limits (429) and upstream errors are retried twice with backoff before they are reported; out of credits, plan limits, an invalid key or an unknown app are not retried.