ahprice for AI coding tools

WoW Forever

Ask your AI about auction prices.

ahprice can answer from Cursor, VS Code, Claude Code, Codex, Gemini CLI, Windsurf, or Zed. No key and no install beyond the one line below. Prices are the shared market average, in copper.

Add to Cursor Add to VS Code

Setup

Copy a snippet.

Cursor

Deeplink, or a project file.

Where: .cursor/mcp.json

Add to Cursor

{
  "mcpServers": {
    "ahprice": {
      "url": "https://ahprice.com/mcp"
    }
  }
}

The config is base64 of {"url":"https://ahprice.com/mcp"}. Web link: https://cursor.com/link/mcp/install?name=ahprice&config=eyJ1cmwiOiJodHRwczovL2FocHJpY2UuY29tL21jcCJ9

VS Code / Copilot

Install link, or a workspace file. The servers key needs type http.

Where: .vscode/mcp.json

Add to VS Code

{
  "servers": {
    "ahprice": {
      "type": "http",
      "url": "https://ahprice.com/mcp"
    }
  }
}

Direct protocol link: vscode:mcp/install?%7B%22name%22%3A%22ahprice%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fahprice.com%2Fmcp%22%7D

Claude Code

Options go before the server name. Add --scope user for every project.

Where: terminal

claude mcp add --transport http ahprice https://ahprice.com/mcp

All projects: claude mcp add --transport http ahprice https://ahprice.com/mcp --scope user

Codex CLI

Streamable HTTP uses --url. The same file is shared with the Codex IDE.

Where: ~/.codex/config.toml

codex mcp add ahprice --url https://ahprice.com/mcp

[mcp_servers.ahprice]
url = "https://ahprice.com/mcp"

No key. Codex connects when no credential is configured.

Gemini CLI

httpUrl is Streamable HTTP. url means the older SSE transport.

Where: .gemini/settings.json

gemini mcp add --transport http ahprice https://ahprice.com/mcp

{
  "mcpServers": {
    "ahprice": {
      "httpUrl": "https://ahprice.com/mcp"
    }
  }
}

User scope is ~/.gemini/settings.json (gemini mcp add --scope user).

Windsurf

Remote servers use serverUrl. url is also accepted.

Where: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ahprice": {
      "serverUrl": "https://ahprice.com/mcp"
    }
  }
}

Cascade's Open MCP config file is ~/.config/devin/mcp_config.json on macOS and Linux, or %AppData%/devin/mcp_config.json on Windows. Same JSON.

Zed

Remote servers live under context_servers, with a url.

Where: settings.json

{
  "context_servers": {
    "ahprice": {
      "url": "https://ahprice.com/mcp"
    }
  }
}

If Zed asks you to sign in, skip it. ahprice does not use an account.

Try it

Example prompts

Using ahprice, what's Linen Cloth worth on US RP PvP (Alliance), and is today's floor a good buy?
List the 10 most profitable tailoring crafts right now, with a materials shopping list.
Chart an item's price over the last 30 days.
Write a Python script that emails me when Copper Bar drops 25% under market.
Is it better to disenchant or sell this item?

Tools

What the agent can call

Tool	What it returns
Lookup
`list_realms`	Realm and faction values, plus how fresh each server's scans are.
`search_items`	Turn an item name into an item id on one realm.
Prices
`get_item_price`	True Value, market average, latest listing, sample count, and confidence.
`get_prices`	The same card for up to 50 item ids.
`price_history`	Snapshot points for 14 days, then one point per day, up to 180 days.
Crafting
`top_crafts`	Trusted profitable crafts. Profit uses True Value, not one listing, after the 5% AH cut.
`get_craft`	Materials and whether each one is bought, vendored, or crafted.
`disenchant_value`	Expected disenchant copper versus selling the item.
Deals
`find_deals`	Latest listings well under True Value, scanned in the last 24 hours.

Every tool is read-only. Prices are per market: one auction house per region, ruleset and faction. Pass a market id such as us-normal-horde from /api/v1/realms as realm. A realm name from the game, or its old slug, still works and returns its market. Faction is alliance or horde.

REST

The same data over HTTP

No key. OpenAPI spec. Money is integer copper, with a text twin such as 1g 20s 5c.

curl "https://ahprice.com/api/v1/items/2589?realm=us-rppvp-alliance&faction=alliance"

Limit	Value
API per IP	60 requests per minute and 2,000 per day
MCP tool calls per IP	600 per minute and 20,000 per day
CSV export	12 per hour
History longer than 30 days	10 per minute
Cache	60 seconds for prices, 5 minutes for crafts, 1 hour for the CSV and the spec

Data

What the numbers mean

The market average weights newer scans more. A price from 7 days ago counts half as much as today. true_value_copper is what it sells for now (the weighted middle of hourly prices, 1-day half-life); deals, disenchant value, and vs_true_value_pct use it. A thin bait listing is not the market. Sample counts under 5 are low confidence. Markets and the realm names they cover follow the live WoW Forever list, so they change when that list changes. Call the realms endpoint rather than hard-coding one.

Prices are pooled from anonymous scans. ahprice never publishes who scanned what. This is World of Warcraft Forever only, and the API stays free.

Empty realms fill in when players scan. Install the addon to add your realm.

Community

Questions about the API

Discord. Claude.ai and ChatGPT can add a custom connector with https://ahprice.com/mcp. No key.