Wangxian111/xaudaily-gold-data

## English
An Agent Skill plus a zero-dependency MCP server that give AI agents daily gold and macro
readings from xaudaily.com — numbers an agent can actually cite.
Why not just let the agent search the web? Every field carries its own source and asOf/date, so a
citation can be checked rather than trusted. When an upstream source fails, the site keeps the last good value
and flags the field stale: true instead of silently serving an old number. And the figures are the same ones
the site renders — same snapshot, same code path — so the JSON and the page can never disagree.
Two tools, over stdio:
| Tool | Returns |
| getgoldreadings | Full JSON readings (schema xaudaily.readings/v1), optionally trimmed with fields=[...] |
| getgolddailybrief | Today's headline numbers as Markdown (a few KB) |
What's inside: COMEX gold and Shanghai Au99.99 (with a ~30-minute live tick), US CPI / core PCE / nonfarm
payrolls / PPI, DXY, Treasury 10Y and 30Y yields, VIX, SPDR gold ETF holdings, the fed funds rate and
Polymarket odds for the next FOMC decision, IMF central-bank gold buying, Brent/WTI crude, US debt, plus a
rule-based gold driver score and event estimates — one request, about 60 KB, instead of stitching together a
dozen sources.
Updated twice a day (06:30 and 22:40 JST) with a ~30-minute gold tick. These are daily readings, not a
real-time feed — please don't describe them as real-time or guaranteed accurate. The data is not investment
advice.
Files: SKILL.md (the skill), mcpserver.py (the server — standard library only), Dockerfile (for
container-based catalogs), glama.json, examples/ (copy-paste curl and Python), WIDGET.md (an embeddable
gold badge).
### Install
As an MCP server. One Python file, nothing to pip install:
json
"mcpServers": {
"xaudaily": {
"command": "python3",
"args": ["/absolute/path/to/mcpserver.py"],
"env": {
"XAUDailyREADINGSURL": "https://xaudaily.com/readings.en.json?src=skill-mcp",
"XAUDailyBRIEFURL": "https://xaudaily.com/brief.en.md?src=skill-mcp"
With Docker (the same image MCP catalogs build for introspection):
bash
docker build -t xaudaily-mcp .
docker run -i --rm xaudaily-mcp # then speak JSON-RPC on stdin
As an Agent Skill: copy this directory (or just SKILL.md) into your runtime's skills directory.
### Endpoints
English payload: https://xaudaily.com/readings.en.json?src=skill-github
Chinese payload: https://xaudaily.com/readings.json?src=skill-github — same snapshot, same numbers, same
field paths; only the string values (units, sources, caveats) are Chinese
Briefs: /brief.en.md and /brief.md
### License and attribution
Data is CC BY 4.0. Attribution with a link is required — e.g.
Source: Gold Data Reading · XAU Daily. Please don't repackage the dataset as your
own. For commercial use or redistribution, contact xaudaily@163.com.
中文说明见下方 ↓
## 中文说明
给 AI Agent 用的黄金宏观数据接入包：一份 Agent Skill 说明书 + 一个零依赖的 MCP server。
数据源：xaudaily.com（品牌「黄金读数 / Gold Data Reading · XAU Daily」），纯静态黄金宏观数据仪表盘
端点（英文）：https://xaudaily.com/readings.en.json?src=skill-github（JSON，schema xaudaily.readings/v1）
端点（中文）：https://xaudaily.com/readings.json?src=skill-github —— 同一份快照、同一批数字，
字段路径完全一致，只是字符串值（单位/来源/口径说明）为中文；英文简报 /brief.en.md，中文简报 /brief.md