ASOMobile
    • Overview ASOMobile API
    • MCP server for AI agents
    • Account
      • Keyword Groups Request
      • Get Apps Request
      • Get Apps Result
      • Keyword Groups Result
      • Usage Request
      • Usage Result
      • Add App Request
      • Add App Result
      • Delete App Request
      • Delete App Result
      • Add Keywords Request
      • Add Keywords Result
      • Delete Keywords Request
      • Delete Keywords Result
    • Reference
      • Categories
      • Countries
      • Languages
    • Apps
      • App Profile Request
        GET
      • App Profile Result
        GET
      • App Competitors Request
        GET
      • App Competitors Result
        GET
    • App Keywords
      • App Keywords Request
        GET
      • App Keywords Result
        GET
      • App Keywords Multiple Countries Request
        POST
      • App Keywords Multiple Countries Result
        GET
    • Keyword Monitor
      • Keyword Monitor Request
        GET
      • Keyword Monitor Result
        GET
    • Keyword Rank
      • Keyword Rank Request
        GET
      • Keyword Rank Result
        GET
    • Keyword Check
      • Keyword Check Request
        GET
      • Keyword Check Result
        GET
    • App Ranking
      • App Ranking Request
        GET
      • App Ranking Result
        GET
      • App Ranking History Request
        GET
      • App Ranking History Result
        GET
    • Keyword Suggest
      • Keyword Suggest Request
        POST
      • Keyword Suggest Result
        GET
    • OrganicDownloads
      • Organic Downloads Request
        GET
      • Organic Downloads Result
        GET
    • WorldWideCheck
      • World Wide Check Request
        POST
      • World Wide Check Result
        GET
    • Top Charts
      • Top Charts Request
      • Top Charts Result
    • Geo Checker
      • Geo Checker Request
      • Geo Checker Result
    • Reviews
      • Reviews Request
      • Reviews Result
    • ASA
      • ASA App Keywords Request
      • ASA App Keywords Result
      • ASA Keyword Check Request
      • ASA Keyword Check Result
    • Keyword Finder
      • Keyword Finder Request
      • Keyword Finder Result
    • Text Analyzer
      • Text Analyzer Request
      • Text Analyzer Result
    • Schemas
      • keyword
      • rank
      • rank
      • OrganicDownloadsResultResponse
      • AppKeywordsRequestresponse
      • OrganicDownloadsKeywordsModel
      • AppKeywordsMultipleCountriesRequest
      • AppKeywordsMultipleCountriesResultResponse
      • AppKeywordsResultresponse
      • platform
      • ios_device
      • WorldWideCheckRequest
      • app_id
      • WorldWideCheckResponse
      • countries
      • country
      • category_id
      • chart
      • count
      • ci
      • keyword2
      • rank
      • rank
      • kei
      • keyword25
      • rank
      • rank
      • traffic
      • rank
      • rank
      • traffic1
      • AverageRating
      • ci1
      • kei1
      • asa
      • change
      • rank
      • rank
      • search_ads
      • TicketIdResponse
      • TopChartsRank
      • Publisher
      • TopChartsAppInfo
      • TopChartsAppItem
      • TopChartsResultResponse
      • GeoCheckerRequest
      • GeoCheckerResultItem
      • ReviewsRequest
      • ReviewReply
      • ReviewItem
      • RatingDistributionItem
      • RatingSummary
      • ReviewsResultResponse
      • AsaKeywordCheckAdvertisedApp
      • AsaAppKeywordsResultItem
      • KeywordGroupItem
      • MessageResult
      • UsageRecentRequestItem
      • AsaKeywordCheckResult
      • AccountAppItem
      • UsageResultResponse
      • CategoryItem
      • CountryItem
      • KeywordFinderResultItem
      • LanguageItem
      • AppRankingHistoryResult
      • TextAnalyzerRequest
      • TextAnalyzerResult
      • KeywordsBatchRequest
      • KeywordsBatchResultItem
      • KeywordsBatchResult

    MCP server for AI agents

    ASOMobile runs an official Model Context Protocol server, so Claude, Cursor, VS Code, Codex and any other MCP client can call the API on your behalf: check keywords, pull an app's indexing, compare competitors, read reviews, analyse metadata text. Every API method is available as a tool (29 tools), each call spends the API tokens of your plan exactly like a direct API request, and your token never leaves the connection between your client and the server.
    Endpoint: https://mcp.asomobile.net/mcp (Streamable HTTP)
    Authentication: header Authorization: Bearer <your API token> from the API Dashboard
    Requirements: a paid ASOMobile plan with API tokens (see Pricing)

    Claude Code#

    Then ask Claude, for example: "Check the keyword taxi in the US App Store" or "Which keywords is id284882215 indexed for in Germany?". A Claude Code plugin with ready-made ASO skills (keyword research, competitor audit, metadata review) is coming soon.

    Cursor#

    ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Keep the token in an environment variable, Cursor substitutes it:
    {
      "mcpServers": {
        "asomobile": {
          "url": "https://mcp.asomobile.net/mcp",
          "headers": { "Authorization": "Bearer ${env:ASOMOBILE_API_TOKEN}" }
        }
      }
    }
    Or install the plugin, which adds the server plus three ASO skills (keyword research, competitor audit, metadata review) and asks for the token once:
    Then ask Claude, for example: "Check the keyword taxi in the US App Store" or "Which keywords is id284882215 indexed for in Germany?".

    VS Code (GitHub Copilot)#

    .vscode/mcp.json. VS Code asks for the token once and stores it securely:
    {
      "inputs": [
        { "type": "promptString", "id": "asomobile-token", "description": "ASOMobile API token", "password": true }
      ],
      "servers": {
        "asomobile": {
          "type": "http",
          "url": "https://mcp.asomobile.net/mcp",
          "headers": { "Authorization": "Bearer ${input:asomobile-token}" }
        }
      }
    }

    OpenAI Codex#

    ~/.codex/config.toml, token from an environment variable:
    [mcp_servers.asomobile]
    url = "https://mcp.asomobile.net/mcp"
    bearer_token_env_var = "ASOMOBILE_API_TOKEN"

    Claude Developer Platform (Messages API)#

    Pass the server in the mcp_servers field of a request; the model gets the tools without any code on your side:
    {
      "mcp_servers": [
        { "type": "url", "url": "https://mcp.asomobile.net/mcp", "name": "asomobile", "authorization_token": "YOUR_API_TOKEN" }
      ]
    }

    Available tools#

    GroupTools
    Keywordskeyword_check, keyword_suggest, keyword_rank, keyword_finder, world_wide_check
    Appsapp_profile, app_competitors, app_keywords, app_keywords_multiple_countries, organic_downloads, geo_checker, reviews, text_analyzer
    Chartsapp_ranking, app_ranking_history, top_charts
    Apple Search Adsasa_app_keywords, asa_keyword_check
    Keyword Monitor and accountkeyword_monitor, account_usage, account_apps, account_keyword_groups, account_add_app, account_delete_app, account_add_keywords, account_delete_keywords
    Reference (free)reference_categories, reference_countries, reference_languages
    Each tool maps to one API method with the same parameters; see the method pages in this documentation for parameter details and the API Dashboard for the cost in API tokens.

    Tips#

    Start with reference_countries or account_usage: they confirm the connection and show the remaining API tokens.
    Tools accept max_items to trim long lists and save the model's context.
    Tools that change your account (account_add_*, account_delete_*) are marked so that clients ask for confirmation first.
    claude.ai and ChatGPT connectors with sign-in instead of a token are coming next.
    Modified at 2026-11-09 17:08:56
    Previous
    Overview ASOMobile API
    Next
    Keyword Groups Request
    Built with