Goblin Eye — start here

Goblin Eye puts your saved auction scans, character information, recipes, item sources and world locations in a local browser dashboard. This complete Windows edition includes the dashboard, MCP research server, optional WoWAI in-game chat, and local Windows speech.

You can use the dashboard without an AI subscription. Optional AI setup comes after the dashboard works. Your local auction workspace is recorded as unknown faction, ruleset, region and realm until a source reports them or you set them in config.json; the dashboard works for any Forever server. Public regional markets are shown separately.

1. Start Goblin Eye

1. Right-click the Goblin Eye ZIP → Extract All. Choose a writable location, such as Documents. Open the extracted Goblin-Eye folder. Extract the whole ZIP: the python folder inside it is the bundled runtime.

2. Double-click Start-Goblin-Eye.cmd. It prepares everything on the first run, then opens the dashboard. Keep its console window open while using it.

3. If the browser does not open, visit http://127.0.0.1:8765/. If the page opens before startup finishes, refresh it once the console says the server is running.

The dashboard needs no additional installation. Python is bundled in the ZIP, so you do not need to install Python, Node.js, npm, pip packages, an API key, or an AI subscription, and you do not need administrator access. Your database starts empty.

Use the launcher inside the extracted folder every time. From PowerShell in that folder, the equivalent is:

.\Start-Goblin-Eye.cmd

The bare command goblin-eye serve can point to a different, previously installed copy even when your terminal is in the correct folder. The included launcher always selects this copy.

Goblin Eye stays in its own folder, outside WoW's AddOns folder.

Related MCP server: wow-api-mcp

2. Install the addons through CurseForge

1. Open CurseForge and select World of Warcraft.

2. Select your Forever game installation. Check that you are managing the same installation you actually play; the supported beta folder is _classic_beta_.

3. Search for and install the addons listed below. Select releases marked Forever / 1.60.1 when a project supports several WoW editions.

4. Let CurseForge install the required dependencies and keep them installed. Restart WoW and check that the addons are enabled on the character screen.

Already installed them through CurseForge? Keep that setup and continue to Get your first data below. There is no need to download addon ZIPs manually.

CurseForge may also install helper libraries; leave those in place. The Goblin Eye ZIP contains the desktop application, while CurseForge manages the addons. For a missing dependency or a manual installation, see the advanced installation notes.

You can start with Alts Forever + AHledger + Auctionator for your character and market data, then add the static research addons. The dashboard opens even without any addons installed.

3. Get your first data

1. Leave Goblin Eye running and log into the character you want to research.

2. Open your bags and profession windows. Visit your bank/mailbox if you want their contents recorded too.

3. At the auction house, finish your Auctionator and AHledger scans.

4. Type /reload in WoW to write the saved addon data to disk. Logging out or exiting WoW normally also saves it.

5. Return to Goblin Eye and check Source health, Characters, and Saved scan overview. Personal saves are checked every few seconds; static addon catalogs are checked every minute. Large first imports can take longer.

There are no manual import commands to run. Keep the dashboard running; supported saved files and changed static catalogs import automatically. The public AHledger reference feed and official Blizzard pages also refresh automatically when internet access is available.

Goblin Eye reads the local AHledger save directly. You do not need AHledger's separate upload/sync app or an AHledger account for this local import.

An import timestamp shows when Goblin Eye read a file; the scan/capture timestamp shows when the game data was recorded. Missing bank, mail or recipe data usually means that category has not been captured yet.

Choose your market

Use a separate extracted Goblin Eye folder for each realm/faction you play. AHledger's newest eligible saved scan identifies an unset local profile; scans from other realms/factions are skipped. Auctionator can identify a single saved realm/faction, but cannot choose between several without that profile.

Auctionator 340 can also save normalized realm keys and regional PvP, PvE or RP buckets. A matching regional bucket requires local_ruleset set explicitly (pvp, normal or rp); it takes priority over old realm storage. Normalized realm keys match the realm selected by AHledger or configuration. Unmatched keys are skipped and shown in Source health; they are never pooled. Saved-file failures appear there even before an addon has imported successfully.

To select a market yourself, stop Goblin Eye, edit these fields in config.json, and restart it. For example, replace Your realm name with your actual realm:

"local_realm": "Your realm name",
"local_faction": "alliance",
"local_region": "eu",
"local_ruleset": "normal"

Faction choices are horde, alliance, neutral, or unknown; ruleset choices are normal, pvp, rp, or unknown. Leave region/ruleset unknown if you do not know them. The realm name alone does not establish either. Once scans have established a profile, changing it to a different market requires a separate copy with an empty database so the prices cannot be mixed.

Upgrades preserve older pooled scans under WoW Forever (legacy identity unverified). Select that market in History to inspect them separately. Fresh scans continue in the current market; no reset or data deletion is needed.

4. Optional: use an AI

The dashboard works on its own. To let an AI query it directly, follow Connect your agent using a client that supports a local MCP connection. Whether a free AI client supports this depends on that client. A browser chat does not automatically gain access to your PC.

You can also copy sourced dashboard results into a free chat service and ask questions about them. Goblin Eye supplies no model, account, credentials or subscription. WoWAI is included as an optional companion; it is not required for the dashboard or other MCP clients. Start-Agent.cmd is the connection endpoint for an AI client; double-clicking it does not open a chat UI.

5. Optional: chat and listen inside WoW

The complete download includes WoWAI with full replies, expandable tool/evidence cards, source links, per-chat settings and supported current model catalogs. Windows Desktop speech can read summaries or full replies. No Warcraft voice recordings or character-cloning assets are included.

Install Node.js 22.2+ and your preferred agent CLI, then run Setup-WoWAI.cmd. It selects your WoW client/account and creates local read-only MCP connections for Codex, Claude and Kilo. Restart WoW, enable WoW AI and its reply slots, then run Start-Goblin-Eye-Chat.cmd and type /wow-ai. Follow In-game chat setup for login, model selection, privacy, custom paths and updates. The dashboard still needs none of these optional dependencies. Free models can be used where your chosen client/provider supports them; no paid subscription is required by Goblin Eye.

What is not connected yet?

GatherLite, AtlasLoot Continued and GuildRoster can be installed for their in-game features, but Goblin Eye currently has no importers for them. They are not required for this setup. Booty Bay Broker and TheWoWDB connectors are also unfinished. See Data connections for exact coverage.

QuestieDB imports static NPC/object locations, not your active quest log. Mapzeroth imports its static graph, not your character's flight discoveries. Goblin Eye does not control gameplay. Auction asking prices do not prove sales, and static spawn references do not show live mob availability.

If something goes wrong

Every friend gets their own database. Keep their data and settings separate. For further details, see Requirements and the Operating guide.