Build an agent or plugin
Discover the API, use the Rust client, and cite observed prices correctly.
Connect a tool
Connect Claude, Claude Code or ChatGPT to https://auctionhouse.fyi/mcp for WoW: Forever item prices, market comparisons, charts and your account settings. Public market questions need no account. Sign in through OAuth to use your watchlist or access contributor and premium features.
claude mcp add --transport http auctionhouse-fyi https://auctionhouse.fyi/mcpIn Claude Code, open /mcp and authenticate when you want account access. In Claude or Claude Desktop, add the URL as a custom remote connector under Customize → Connectors. In ChatGPT, enable Developer mode under Settings → Security and login, then add the URL in Plugins. Host availability and workspace policy may affect these options.
See the MCP setup and administrator guide, Claude Code instructions, Claude connector instructions and official OpenAI connection guide.
Basic market dataPublic- Item search, metadata, hourly prices, overall quantity and up to seven days of daily/hourly charts. No API key required.
Your watchlistSigned in- Free accounts can save 20 items; contributor and premium accounts can save 200.
Deeper researchContributor / premium- Latest observed prices, order books, estimated volume, minute charts and up to 90 days of daily history. Hourly retention is 14 days and minute retention is 72 hours.
Alerts and boardsContributor / premium- Up to 100 alerts and 20 saved dashboards. Account changes require confirmation.
Ask “Show Runecloth's last day in Normal Alliance” or “Compare Runecloth across Alliance and Horde.” Use get_access to inspect your current features and limits. render_item_chart and open_market_explorer return interactive MCP Apps UI in supported hosts, including ChatGPT sidebar entry points; tools also return JSON for clients without UI.
The inline widget works without sign-in for basic charts and listed quantity. Contributor and premium access adds minute charts, daily volume estimates, order book price levels and market analysis in the same view. Refresh checks your current access; your ChatGPT subscription does not change your Auction House FYI tier.
For direct HTTP integrations, import the OpenAPI 3.1 contract or use the Rust client below. Start with GET /api/v1/ah to discover observations; an empty market list is valid. The endpoint directory documents the API. Discover public pages at llms.txt; request them with Accept: text/markdown for compact text.
Report market facts
Preserve the exact market and item key, including variants. Prices are integer copper per unit: 10,000 copper is one gold. The row is [priceOrNull, quantity, observedAtMs]; a null row means no observation, and a null price means none listed at the last complete scan. Neither means the item is free.
Cite https://auctionhouse.fyi/item/{key}?m={market} and state the observation time. The response's now is server time. Public data is hourly, and estimated volume is not confirmed sales. Prices are historical observations, not executable quotes.
Honor Retry-After on 429, stop on tier refusals, and keep credentials in the client's credential store. OAuth may ask you to sign in or consent to an additional scope. Use get_access through MCP or /api/v1/me through HTTP for current features and limits. MCP does not upload scans. Direct upload integrations require explicit user intent and actual observations; never upload synthetic examples or another service's data.
This service cannot bid, buy, post or cancel game auctions. It neither reads the game process nor sends input. Scans contain no seller, bidder or character names.
Download the Rust client
The standalone example is available publicly from this website; no private repository access is needed.
- Build and integration instructions
- Cargo manifest and dependency lockfile
- Rust source and tool definition
cargo run --locked -- forever.normal.horde.us 2589Versioned contracts and runnable examples live with the source specification →.