ASOHawk

io.github.prodocikPublished by GitHub account prodocikv0.1.1Updated Oct 27, 2026

ASO analytics and App Store optimization tools for indie iOS developers and AI agents.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for ASO analytics: lets an assistant read App Store rankings, keywords, competitors, reviews and revenue, and propose listing changes.

What you can do
  • Read rankings, keyword tracking, competitor discovery and monitoring, review streams, chart moves and revenue for your apps and any App Store app.
  • Score keyword difficulty and popularity, including exact Apple Search Ads popularity on demand.
  • Review ASO health, recommendations, acquisition and retention funnels, hypotheses and learnings.
  • Propose App Store Connect changes: metadata and screenshot edits, native A/B tests, paid-app, IAP and subscription repricing, build attachment and App Review submission.
  • List available capabilities and follow a consistent response envelope with data freshness, limitations and cost class.
When to use it
Useful for indie iOS developers who want an agent to pull App Store ranking, keyword, competitor, review and revenue data and turn it into growth reports or keyword opportunities. Also fits teams that want listing and pricing changes drafted by an agent but approved by a human before they reach App Store Connect.
Requirements
A remote HTTPS endpoint; nothing to install locally. An ASOHawk account (free plan, no credit card) and a workspace API key created in Settings, sent as an Authorization bearer header. Write tools require a key with write permission. Network access to the hosted service.
Before you install
The API key is a workspace credential sent in the Authorization header; keep it out of config files where possible. Write tools can change metadata, screenshots, prices, subscriptions and App Review submissions, though changes are proposals awaiting human approval in the dashboard. Some operations may incur cost, indicated by a cost class. Data is sent to the hosted ASOHawk service.

Installation

In SourceWeft

  1. Open ASOHawk in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.prodocik%2Fasohawk/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "asohawk": {
      "type": "http",
      "url": "https://asohawk.cc/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

[ASOHawk]

App Store Optimization, built for AI agents.

[Website] [MCP Registry] [Tool count]

ASOHawk is an ASO platform your AI agent uses directly. It speaks MCP, the protocol Claude Code, Claude Desktop, Cursor, Codex and most agent CLIs already understand. Point an agent at it once and it reads your App Store rankings, keywords, competitors, reviews and revenue, and manages tracking and metadata on request.

The web dashboard exists too, but the agent is a first-class citizen, not an afterthought: every capability is a versioned tool with an explicit contract, honest limitations, and a safety model where anything that touches your App Store listing waits for your approval.

How it works

[Your agent connects to ASOHawk over MCP; ASOHawk reads the App Store and writes to App Store Connect after human approval.]

The server is remote MCP over HTTPS. Nothing to install, nothing to run, no local database: one config block in your client and the agent is connected.

Quick start

1. Create a key. Sign up at asohawk.cc (free plan, no credit card), then open Settings → API keys and create a key. Read by default; add write to let the agent manage tracking.

2. Connect. For Claude Code, run once in any terminal:

sh
claude mcp add --transport http --scope user asohawk https://asohawk.cc/api/mcp --header "Authorization: Bearer ahk_YOUR_KEY"
Claude Desktop

Settings → Developer → Edit Config, then add:

json
{  "mcpServers": {    "asohawk": {      "type": "http",      "url": "https://asohawk.cc/api/mcp",      "headers": {        "Authorization": "Bearer ahk_YOUR_KEY"      }    }  }}
Cursor

Save as .cursor/mcp.json in your project, or ~/.cursor/mcp.json to make it available everywhere:

json
{  "mcpServers": {    "asohawk": {      "url": "https://asohawk.cc/api/mcp",      "headers": {        "Authorization": "Bearer ahk_YOUR_KEY"      }    }  }}
Codex

Add to ~/.codex/config.toml:

toml
[mcp_servers.asohawk]url = "https://asohawk.cc/api/mcp"
[mcp_servers.asohawk.http_headers]Authorization = "Bearer ahk_YOUR_KEY"

To keep the key out of the file, use codex mcp add with --bearer-token-env-var ASOHAWK_API_KEY instead.

Qwen Code

Add to ~/.qwen/settings.json:

json
{  "mcpServers": {    "asohawk": {      "httpUrl": "https://asohawk.cc/api/mcp",      "headers": {        "Authorization": "Bearer ahk_YOUR_KEY"      }    }  }}
Kimi CLI
sh
kimi mcp add --transport http asohawk https://asohawk.cc/api/mcp --header "Authorization: Bearer ahk_YOUR_KEY"
Gemini CLI, VS Code and any other MCP client

Gemini CLI takes the same httpUrl block as Qwen Code in ~/.gemini/settings.json. VS Code takes a servers block in .vscode/mcp.json. Any client that reads mcp.json works with the standard shape:

json
{  "mcpServers": {    "asohawk": {      "type": "http",      "url": "https://asohawk.cc/api/mcp",      "headers": {        "Authorization": "Bearer ahk_YOUR_KEY"      }    }  }}

Exact snippets for every client, plus a stdio bridge for clients without remote MCP support, are in the getting started guide.

3. Ask. The agent calls ASOHawk and answers in plain language:

Give me a growth report for my apps this week.

Who are my top competitors and which keywords do they rank for that I don't?

Find new keyword opportunities for my app and track the best ones.

How many downloads and how much revenue does https://apps.apple.com/us/app/duolingo/id570060128 get?

What the agent can do

64 tools cover the full ASO loop: rankings and keyword tracking, competitor discovery and monitoring, review streams, ASO health and recommendations, acquisition and retention funnels, revenue, keyword difficulty and popularity scoring, exact Apple Search Ads popularity on demand, chart moves, hypotheses and learnings, App Store Connect metadata edits, screenshot changes, native A/B tests (Product Page Optimization), paid-app, IAP and subscription repricing (one territory or a purchasing-power matrix across all 175), build attachment and App Review submission.

Every tool returns the same envelope: the answer under data, plus data_freshness, honest limitations, recommended_next_capabilities and a cost_class. Agents do not guess what a number means or what to call next; the response says so.

Lists inside data are tabular — {columns, rows} with positional cells — so a field name is written once, not once per row; the server states that reading rule in its instructions. Connecting with ?profile=core (or ?profile=keywords,changes) lists fewer tools up front without changing what the key may call: list_capabilities still names everything, marking what the profile left out.

  • Tool reference: every tool with its contract, generated from the live registry.
  • Playbooks: 16 step-by-step recipes, from onboarding an app to shipping a build through App Review.
  • Concepts: authentication, permissions, the response envelope, errors, cost classes.
  • Prompt library: copyable everyday prompts for setup, data, ASO work and safe execution.

Built for trust

  • Scoped keys. Read keys see read tools only; write tools are invisible to them, not just refused.
  • Human approval on writes. Metadata changes, screenshot changes, price changes and App Review submissions are proposals first. A human approves them in the dashboard before anything reaches App Store Connect. High-risk operations (name or description rewrites, prices, review submissions) wait for a human even in workspaces that enable auto-apply. The single exception, off by default and per call: a purchasing-power price matrix may run on auto when every territory already has a price and none of them moves more than 15%.
  • Durable subscription repricing. A country-wide subscription matrix runs in the background with per-territory progress. It is marked applied only after a complete live App Store Connect read verifies every country; failed runs require an explicit reconciled resume, and ambiguous network outcomes are never retried blindly. Existing subscribers keep their price.
  • Per-domain read controls. Each data domain can be switched off for agents independently.
  • A closed error contract. Refusals carry a reason code, whether a retry can succeed, and alternative tools; agents recover instead of hallucinating.

Details in concepts.

Links

ASOHawk is a hosted service; this repository is its public documentation. Found a gap or want a tool that is missing? Open an issue.

Source: README.md at commit 3fb086d

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.