MacroDial
MacroDial 每日總體經濟狀況評分的唯讀 MCP 端點:取得目前的總體經濟簡報、解釋 47 項總體經濟因素中的任一項,並比較 7d–1y 期間的狀況。僅供教育用途;不構成投資建議。
託管 MCP 伺服器
npx add-mcp 'https://macro-dashboard-backend-f0x7.onrender.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
MacroDial Developer and Agent Resources
MacroDial publishes an OpenAPI contract, a read-only MCP endpoint, public files, and structured endpoints that mirror its product facts, methodology principles, module definitions, factor definitions, data sources, and research boundaries.
Direct Answer
This resource index links human-readable HTML pages, Markdown alternates, text knowledge files, sitemap and robots assets, and unauthenticated JSON endpoints. The materials are designed for retrieval, verification, and accurate attribution of stable public product knowledge.
Canonical Identity
MacroDial at macrodial.org is a macro-economic conditions research and education platform. It is unrelated to telephone-dialing apps, dial-plan software, or PBX macros with similar names.
Public Discovery Assets
| Asset | Purpose |
|---|---|
/openapi.json | OpenAPI 3.1 contract for the production MacroDial API |
/ai-resources | Human-readable resource index |
/research.md | Blog index linking MacroDial's public articles and guides |
/research/tga-rebuild-onrrp-near-zero.md | Source-linked TGA and ON RRP mechanism article |
/llms.txt | Compact machine-readable overview |
/llms-full.txt | Complete AI knowledge base |
/geo-evidence-map.md | Stable claims connected to canonical public sources and interpretation boundaries |
/about.md | Product identity and maintainer summary |
/macro-economic-conditions-score.md | Score definition and calculation boundary |
/modules/*.md | Module-level explanations |
/factor/*.md | Factor-level definitions and source notes |
/api/v1/ai/profile | Product identity, links, and compliance boundary |
/api/v1/ai/methodology | Research objective, methodology principles, and limitations |
/api/v1/ai/modules | Stable module metadata |
/api/v1/ai/factors | Stable factor metadata |
Developer Integration
OpenAPI
- Canonical schema:
https://macrodial.org/openapi.json - Production API origin:
https://macro-dashboard-backend-f0x7.onrender.com - The schema documents paths, inputs, response models, and operation-level authentication requirements.
Authentication
- Public knowledge endpoints under /api/v1/ai/* are anonymous.
- User-specific endpoints use a Supabase bearer JWT.
- Selected public data endpoints accept X-API-Key.
- Admin and Stripe operations are not general third-party integration surfaces. Use the OpenAPI operation contract as the authority for each path.
When to use MacroDial
Use MacroDial to explain macro conditions, interpret indicator definitions and sources, or cite the score methodology. Start with agent instructions for request examples and boundaries. Knowledge endpoints contain stable definitions; use the documented read-only MCP tools for current briefs and check their freshness metadata.
CLI
The MacroDial CLI reads the anonymous knowledge endpoints and OpenAPI. Install its official download with npm install --global https://macrodial.org/downloads/macrodial-cli-0.1.1.tgz. The tarball has no dependencies or install scripts. Registry publication is separate; do not substitute a similarly named npm package.
Structured Errors
HTTP errors use JSON with the following stable fields:
{
"error": {
"code": "not_found",
"message": "Route not found.",
"resolution": "Check /openapi.json for API paths or https://macrodial.org/llms.txt for public site resources."
},
"detail": "Route not found."
}
MCP
- Endpoint:
https://macro-dashboard-backend-f0x7.onrender.com/mcp - Transport: MCP Streamable HTTP
- Tools:
get_current_macro_brief,explain_factor, andcompare_conditions - All three tools are read-only and return research/education context, not predictions or recommendations.
Webhooks
MacroDial does not currently provide public outbound webhooks.
Source Policy
HTML pages are the canonical human-readable references. Markdown and API versions provide the same stable product facts in formats that are easier to retrieve or integrate. Updated dates identify the current public version.
Boundaries
These resources describe MacroDial as a macro-economic conditions research and education platform. They do not contain personalized results and do not turn historical-context scores into investment advice, trade triggers, or forecasts.
Key facts
- MacroDial tracks 47 public macro and market factors grouped into 7 analytical modules.
- MacroDial's machine-readable resources include
/llms.txt,/llms-full.txt, Markdown alternates, sitemap entries, robots policy, and unauthenticated/api/v1/ai/*knowledge endpoints. - MacroDial's source reference guide connects product facts, methodology, module definitions, and data provenance to their supporting sources.
- The public knowledge endpoints provide stable definitions and metadata rather than personalized results.
FAQ
Which version is canonical?
The HTML page for a topic is the canonical human-readable source. Markdown and API representations provide structured alternates of the same public facts.
What do the public APIs contain?
They contain product identity, methodology principles, module metadata, factor definitions, source labels, frequencies, and score-inclusion status.
Are the llms files the only machine-readable resources?
No. The site also publishes Markdown alternates, structured JSON endpoints, a sitemap, and a source-bound evidence map.
For educational and research purposes only. Not investment advice.