Hesper Atlas Evidence
Verify stock signals, replay evidence, provenance, freshness, and caveats.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"hesper-atlas": {
"url": "https://hesperatlas.com/mcp"
}
}
}遠端端點
https://hesperatlas.com/mcpstreamable-http它能做什麼
工具清單
工具（15）
🟢get_track_record(open_limit, open_offset)
Use when a user asks whether Hesper Atlas's headline track record is supported, or wants winning, losing and still-open periods. Returns headline performance of today's trend engine replayed over up to five years of historical end-of-day data: number of closed signals, win rate, average winner vs average loser, average hold, plus a summary and bounded page of the open book (positions still running, marked at the last close). Winning and losing replay signals are both included. This is a retrospective replay, not an append-only live record. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"open_limit": {
"type": "integer",
"minimum": 0,
"maximum": 50,
"description": "Open positions to return, default 10, max 50. Pass 0 for summary only."
},
"open_offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Open positions to skip, for paging."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_ledger_stats(section)
Use when a user asks for drawdowns, weak periods, best-versus-worst results, or whether a headline hides an unfavorable distribution. Returns detailed cuts of the current-rule historical replay: per calendar year, per theme, return distribution buckets, holding periods, the ten best and ten worst closed trades, the open book, and closed+open combined on identical buckets. Use `section` to pull one cut instead of all of them. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"section": {
"type": "string",
"enum": [
"all",
"by_year",
"by_theme",
"distribution",
"hold",
"extremes",
"open_book",
"all_signals"
],
"description": "Which cut to return. Default 'all'."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_symbol_record(symbol)
Use when a user asks how Hesper Atlas's current rules historically behaved on one ticker. Returns every closed round trip produced on one ticker (entry date, entry price, exit date, exit price, return, days held), plus its open position if it currently has one. This is retrospective history, not a forward record or current recommendation: use get_signal for the latest end-of-day state. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
}
},
"required": [
"symbol"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢list_closed_trades(limit, offset, symbol, since)
The raw closed-signal historical replay, newest exit first, filterable by symbol and exit date. Winners and losers both; nothing is excluded from the replay. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Rows to return, default 50, max 200."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Rows to skip, for paging."
},
"symbol": {
"type": "string",
"description": "Only this ticker."
},
"since": {
"type": "string",
"description": "Only exits on or after this date (YYYY-MM-DD)."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_methodology
Use before interpreting a performance or signal claim, especially when a user asks for assumptions, limitations or possible bias. Explains how the engine decides, what the published numbers do and do not claim, and the known biases in the record. Read this before quoting any statistic from the other tools.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢list_forward_publications(limit, since_as_of)
Use when a user asks what Hesper Atlas actually published, when it was committed, what changed, or whether forward history is mature enough to evaluate. Returns public append-only manifests for end-of-day signal publications: stable publication id, publication time, market-data as-of date, scan schema, record counts, previous-publication link and a SHA-256 commitment over the exact frozen agent-facing signal rows. A compact summary separates snapshot revisions from distinct market dates and explicitly refuses to calculate performance from commitments. The manifests prove what was committed without exposing the paid current signal book. The ledger begins at deployment; there is no fabricated historical backfill. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Newest manifests to return, default 30."
},
"since_as_of": {
"type": "string",
"description": "Only snapshots on or after YYYY-MM-DD."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_heldout_evidence(symbol, offset, limit)
Use when a user wants to reconstruct or challenge the 152-name static-tail validation headline. Returns the committed row-level artifact, including its content-derived run id, SHA-256 digest, split and execution manifest, aggregate summary, and paged per-symbol engine versus buy-and-hold CAGR and max-drawdown rows. The chronological tail was originally withheld but was reused in later research, so the response labels it validation rather than a pristine unseen test. Backtested signal evidence, not live performance or advice.
輸入結構描述
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Rows to skip, default 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Rows to return, default 25, max 100."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_walk_forward_evidence(artifact, symbol, offset, limit, include_inputs)
Use when a user asks for stricter time-ordered evidence, weak years, benchmark underperformance, or a check against look-ahead. Returns the committed cache-frozen annual walk-forward artifact. Each year's candidate is selected using only earlier observations and then traded for the next calendar year with next-open execution and costs. Returns the content-derived evidence id, input hash manifest, aggregate results, and paged per-symbol/year rows. Weak periods and underperformance versus buy-and-hold are retained. Set artifact to 'pooled_selection' for the class-pooled selection audit (per-name and pooled rule selection both converge to the untuned class engine) or 'model_portfolio' for the monthly walk-forward of the shipped model-portfolio construction (12-1 momentum top 10/20 among engine-long quality stocks, every risk profile, benchmarks, monthly picks, broad-universe check). Historical validation, not live performance or advice.
輸入結構描述
{
"type": "object",
"properties": {
"artifact": {
"type": "string",
"enum": [
"per_name",
"pooled_selection",
"model_portfolio"
],
"description": "Which artifact. Default per_name."
},
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Rows to skip, default 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Rows to return, default 25, max 100."
},
"include_inputs": {
"type": "boolean",
"description": "Include all committed input-file hashes; default false for compact responses."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_provenance
Use when a user asks where a number came from, whether two results used the same code, or what first-party hashes can and cannot prove. Returns the authoritative public methodology version, content-derived published-decision and evaluation-pipeline calculation versions, component SHA-256 hashes, canonicalization rule and attestation limitations. Use it to determine whether two figures came from the same rules/code. It explicitly states that no independent timestamp authority or third-party signer is configured.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_signal(symbol)
Use when an authorized user asks for the latest Hesper Atlas action on one ticker; do not substitute replay data if access is missing. Returns the latest completed end-of-day state: the bot-safe action and target position, confirmed engine ownership state, conviction score, both the published current leg and longer-history first entry, trend extension, relative strength, fundamental health grade, valuation rating, sell-risk level and the trade-plan trigger prices. `action` and `suggested_position` are authoritative when a trigger has been crossed. Requires an active Hesper Atlas subscription. Signal data, not investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
}
},
"required": [
"symbol"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢list_signals(kind, limit)
The engine's current lists. `recent_entries` is the chronological entry history inside the scan window, even if a name is now HOLD or risky. `recent_buys` is actionable now: still BUY/STRONG BUY and not critical sell-risk. Also supports recent sells, positions at risk, ranked opportunities, undervalued names, catch-up candidates, and the on-deck watch roster. Requires an active subscription. Signal data, not advice.
輸入結構描述
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"recent_buys",
"recent_entries",
"recent_sells",
"at_risk",
"opportunities",
"undervalued",
"catch_up",
"on_deck"
],
"description": "Which list. Default 'recent_buys'."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"description": "Rows to return, default 20, max 60."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_market_context
Whole-tape context the per-name signals sit inside: risk regime, breadth (share of the universe the engine is long), the market heat / froth reading with its suggested position-size multiplier, and the cycle read. Requires an active subscription.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_model_portfolio(n)
The Hesper Atlas model book: quality stocks the class engine is long, ranked by 12-month momentum at the last month-end session, inverse-volatility weighted times engine exposure and scaled to a volatility target, with each position's weight and the names the engine is standing aside on. The same construction as the public walk-forward at /api/model-portfolio-evidence. Requires an active subscription. Not personalized advice: it is one rules-based construction, blind to your circumstances.
輸入結構描述
{
"type": "object",
"properties": {
"n": {
"type": "integer",
"enum": [
10,
20
],
"description": "Position count. Default 10."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_forward_record(publication_id, symbol, offset, limit)
Exact immutable agent-facing signal rows for one append-only publication, including stable signal ids, previous-row links and changed-field classifications. Defaults to the latest publication and supports symbol filtering and pagination. Requires an active subscription. Completed end-of-day data, not real-time or advice.
輸入結構描述
{
"type": "object",
"properties": {
"publication_id": {
"type": "string",
"description": "Stable hsp_pub_... id; omit for latest."
},
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Rows to skip, default 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Rows to return, default 50, max 200."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}🟢get_changes_since(since_publication_id, symbol, material_only, offset, limit)
Chronological before/after events after a stable forward-publication cursor. By default returns only stance, target-size and actionable risk changes; set material_only=false to include mark and score updates. Supports one-symbol filtering and pagination. Requires an active subscription. Completed end-of-day data, not real-time or investment advice.
輸入結構描述
{
"type": "object",
"properties": {
"since_publication_id": {
"type": "string",
"description": "Exclusive stable hsp_pub_... cursor."
},
"symbol": {
"type": "string",
"description": "Ticker symbol, e.g. NVDA. Case-insensitive."
},
"material_only": {
"type": "boolean",
"description": "Default true; false also returns non-material mark updates."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 100000,
"description": "Events to skip, default 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Events to return, default 100, max 200."
}
},
"required": [
"since_publication_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"disclaimer": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"last_updated": {
"type": [
"string",
"null"
]
},
"data_type": {
"type": "string"
},
"is_live": {
"type": "boolean"
},
"methodology_version": {
"type": [
"string",
"null"
]
},
"calculation_version": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "object"
},
"provenance": {
"type": "object"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"disclaimer"
]
}社群
證據