mcp-server-saxo-openapi 0.1.1__tar.gz

mcp_server_saxo_openapi-0.1.1/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+.eggs/
+build/
+.venv/

mcp_server_saxo_openapi-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing
+
+Thank you for your interest in **mcp-server-saxo-openapi**.
+
+## What we welcome
+
+- Bug reports and reproducible examples for `saxo-doc-helper` / MCP
+- Improvements to CLI/MCP ergonomics (normalization, error messages, tests)
+- Documentation fixes in `README.md` / `README.ja.md`
+
+## What is harder to accept
+
+- Hand-editing large files under `spec/json/` — specs are generated from the Saxo Developer Portal. Prefer the maintainer regeneration flow.
+
+## Updating the spec database
+
+If you maintain a full development workspace with the crawler pipeline, see [docs/MAINTAINER.md](docs/MAINTAINER.md).
+
+Otherwise, open an issue describing which Saxo endpoint or schema looks stale, with a link to the official Saxo reference page.
+
+## Development setup
+
+```bash
+git clone https://github.com/nohikomiso/mcp-server-saxo-openapi.git
+cd mcp-server-saxo-openapi
+uv sync
+uv run python -m unittest discover -s tests -v
+```
+
+No third-party runtime dependencies (Python standard library only).
+
+Before a release, sync packaged data from the maintainer source of truth:
+
+```bash
+rm -rf src/saxo_doc_helper/data/json
+cp -a spec/json src/saxo_doc_helper/data/json
+```
+
+## Pull requests
+
+1. Fork and create a branch from `main`
+2. Run `uv run python -m unittest discover -s tests -v`
+3. Keep README changes in sync across English and Japanese when both are affected
+4. Open a PR with a short summary and test evidence
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

mcp_server_saxo_openapi-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nohikomiso
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_server_saxo_openapi-0.1.1/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: mcp-server-saxo-openapi
+Version: 0.1.1
+Summary: MCP server and CLI for Saxo Bank OpenAPI spec lookup (offline; no trading)
+Project-URL: Homepage, https://github.com/nohikomiso/mcp-server-saxo-openapi
+Project-URL: Repository, https://github.com/nohikomiso/mcp-server-saxo-openapi
+Project-URL: Issues, https://github.com/nohikomiso/mcp-server-saxo-openapi/issues
+Author: nohikomiso
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,mcp,model-context-protocol,openapi,saxo,saxo-bank,saxobank,trading
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# mcp-server-saxo-openapi
+
+**Saxo Bank OpenAPI spec lookup — CLI tool and MCP server**
+
+English | [日本語](https://github.com/nohikomiso/mcp-server-saxo-openapi/blob/main/README.ja.md)
+
+---
+
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
+![CLI](https://img.shields.io/badge/CLI-saxo--doc--helper-blue.svg)
+![MCP](https://img.shields.io/badge/MCP-stdio-orange.svg)
+![Spec updated](https://img.shields.io/github/last-commit/nohikomiso/mcp-server-saxo-openapi/main?label=spec%20updated)
+
+Look up **Saxo Bank** / **Saxobank** OpenAPI endpoint parameters and JSON samples from your terminal, or attach the same tools to Cursor, Claude Desktop, and other MCP clients — without wrestling the deep official reference tree.
+
+Zero third-party dependencies (Python stdlib only). Spec database: ~260 endpoints across 17 service groups, shipped inside the wheel.
+
+---
+
+## Spec snapshot
+
+**Spec snapshot: 2026-07-08** (Saxo Release Notes through **2025/05/15**).
+
+Structured endpoint specs for agents and developers. Saxo does not publish a single docs semver; we record the crawl date and the newest Release Notes heading present at that time. Details: [SPEC_FRESHNESS.md](SPEC_FRESHNESS.md).
+
+Missing endpoint, wrong parameter, or something that looks out of date? Please [open an Issue](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues). Pull requests: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## What this is / is not
+
+| This package | Not this package |
+|--------------|------------------|
+| Offline **spec lookup** (CLI + MCP) | Live trading / portfolio API calls |
+| No Saxo credentials required | OAuth, order placement, balances |
+| Token-efficient progressive disclosure | A substitute for a full OpenAPI client |
+
+For **live** Saxo OpenAPI access from an MCP client, see community servers such as [`@borgels/mcp-server-saxo`](https://www.npmjs.com/package/@borgels/mcp-server-saxo) (npm, unofficial, separate project).
+
+**Unofficial** — not affiliated with or endorsed by Saxo Bank A/S.
+
+---
+
+## Features
+
+- **Structured spec database** — nested parameters and request/response samples
+- **CLI** — `search-endpoints`, `get-endpoint`, `get-schema` with depth control and "Did you mean?" suggestions
+- **MCP server** — stdio JSON-RPC; same three tools
+- **Token-efficient** — progressive disclosure (collapsed nested schemas, drill down on demand)
+
+**Requirements:** Python 3.10+
+
+---
+
+## Getting started — recommended (uvx)
+
+### Production PyPI
+
+```bash
+uvx mcp-server-saxo-openapi
+uvx --from mcp-server-saxo-openapi saxo-doc-helper search-endpoints orders
+uvx --from mcp-server-saxo-openapi saxo-doc-helper --version
+```
+
+`uvx` resolves the **package** name; use `--from mcp-server-saxo-openapi` to run the `saxo-doc-helper` console script.
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "saxo-openapi": {
+      "command": "uvx",
+      "args": ["mcp-server-saxo-openapi"]
+    }
+  }
+}
+```
+
+### From GitHub
+
+```bash
+uvx --from git+https://github.com/nohikomiso/mcp-server-saxo-openapi.git saxo-doc-helper search-endpoints orders
+uvx --from git+https://github.com/nohikomiso/mcp-server-saxo-openapi.git mcp-server-saxo-openapi
+```
+
+### TestPyPI (development only)
+
+```bash
+uvx --index-url https://test.pypi.org/simple/ \
+    --index https://pypi.org/simple/ \
+    --from mcp-server-saxo-openapi \
+    saxo-doc-helper search-endpoints orders
+```
+
+---
+
+## Getting started — local clone
+
+```bash
+git clone https://github.com/nohikomiso/mcp-server-saxo-openapi.git
+cd mcp-server-saxo-openapi
+python tools/saxo_doc_helper.py search-endpoints orders
+python tools/saxo_doc_helper.py get-endpoint POST /trade/v2/orders
+python tools/saxo_doc_helper.py get-schema algorithmicorderdata
+```
+
+Or install editable:
+
+```bash
+uv sync
+uv run saxo-doc-helper --version
+uv run saxo-doc-helper search-endpoints orders
+```
+
+### Input normalization
+
+| Input | Normalized |
+|-------|------------|
+| `post` | `POST` |
+| `trade/v2/orders` | `/trade/v2/orders` |
+| `https://gateway.saxobank.com/sim/openapi/trade/v2/orders` | `/trade/v2/orders` |
+
+If no exact match is found, **Did you mean?** suggestions are returned.
+
+---
+
+## MCP tools exposed
+
+| Tool | Description |
+|------|-------------|
+| `search_saxo_endpoints(query)` | Keyword search across all endpoints |
+| `get_saxo_endpoint_spec(method, path, depth?)` | Parameters + request/response samples |
+| `get_saxo_schema_spec(schema_name, depth?)` | Nested schema drill-down |
+
+---
+
+## Agent integration
+
+> When researching Saxo OpenAPI specs, do **not** read `spec/json/` files directly.  
+> Use `saxo-doc-helper` (or `python tools/saxo_doc_helper.py` from a clone).
+
+---
+
+## Repository layout
+
+```text
+mcp-server-saxo-openapi/
+├── pyproject.toml
+├── SPEC_FRESHNESS.md
+├── LICENSE
+├── README.md / README.ja.md
+├── CONTRIBUTING.md
+├── docs/
+│   └── MAINTAINER.md
+├── src/saxo_doc_helper/   # installable package (+ data/json)
+├── spec/json/             # maintainer source of truth
+├── tests/
+└── tools/
+    └── saxo_doc_helper.py # thin clone-compatible wrapper
+```
+
+---
+
+## Related projects
+
+| Project | Role |
+|---------|------|
+| [saxo-apy](https://github.com/nohikomiso/saxo-apy) | OAuth and session management |
+| [saxo-openapi](https://github.com/nohikomiso/saxo-openapi) | Python REST/WebSocket client (AI-ready) |
+| [@borgels/mcp-server-saxo](https://www.npmjs.com/package/@borgels/mcp-server-saxo) | Live Saxo OpenAPI MCP (npm; unofficial) |
+
+This repository provides **spec lookup**. Runtime API access is a separate concern.
+
+---
+
+## Feedback and maintainers
+
+- Bugs / stale specs: [GitHub Issues](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues)
+- Maintainers: [docs/MAINTAINER.md](docs/MAINTAINER.md)
+- Source crawl: public Saxo Developer Portal reference docs
+
+---
+
+## License
+
+[MIT License](LICENSE)

mcp_server_saxo_openapi-0.1.1/README.ja.md

@@ -0,0 +1,146 @@
+# mcp-server-saxo-openapi
+
+**Saxo Bank / サクソバンク証券 OpenAPI 仕様ルックアップ — CLI と MCP サーバー**
+
+[English](https://github.com/nohikomiso/mcp-server-saxo-openapi/blob/main/README.md) | 日本語
+
+---
+
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
+![CLI](https://img.shields.io/badge/CLI-saxo--doc--helper-blue.svg)
+![MCP](https://img.shields.io/badge/MCP-stdio-orange.svg)
+![Spec updated](https://img.shields.io/github/last-commit/nohikomiso/mcp-server-saxo-openapi/main?label=spec%20updated)
+
+ターミナルまたは Cursor / Claude Desktop などの MCP クライアントから、**サクソバンク証券（Saxo Bank）** OpenAPI のエンドポイントパラメータと JSON サンプルを参照できます。公式リファレンスツリーが深すぎて辿りにくい、という問題向けです。
+
+サードパーティ依存なし（Python 標準ライブラリのみ）。仕様 DB は約 260 エンドポイント / 17 サービスグループで、wheel にも同梱されます。
+
+---
+
+## Spec snapshot
+
+**Spec snapshot: 2026-07-08**（Saxo Release Notes through **2025/05/15**）。
+
+エージェント向けに再構成したスナップショットです。Saxo にドキュメント全体の semver はなく、クロール日と当時の最新 Release Notes 見出しを記録します。詳細: [SPEC_FRESHNESS.md](SPEC_FRESHNESS.md)。
+
+欠け・誤り・古さを見つけたら [Issue](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues) をください。PR: [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+---
+
+## これは何か / 何かではないか
+
+| 本パッケージ | 対象外 |
+|--------------|--------|
+| オフラインの **仕様ルックアップ**（CLI + MCP） | ライブ取引・ポートフォリオ API |
+| Saxo 認証情報は不要 | OAuth・発注・残高照会 |
+| トークン効率の段階的開示 | フル OpenAPI クライアントの代替 |
+
+**ライブ** API を MCP から叩く場合は、コミュニティの [`@borgels/mcp-server-saxo`](https://www.npmjs.com/package/@borgels/mcp-server-saxo)（npm・非公式・別プロジェクト）などを参照。
+
+**非公式** — Saxo Bank A/S との提携・推奨はありません。
+
+---
+
+## 機能
+
+- **構造化仕様 DB** — ネストパラメータと Request/Response サンプル
+- **CLI** — `search-endpoints` / `get-endpoint` / `get-schema`（depth 制御・Did you mean?）
+- **MCP サーバー** — stdio JSON-RPC、同じ 3 ツール
+- **トークン効率** — 段階的開示
+
+**要件:** Python 3.10+
+
+---
+
+## はじめに — 推奨（uvx）
+
+### 本番 PyPI
+
+```bash
+uvx mcp-server-saxo-openapi
+uvx --from mcp-server-saxo-openapi saxo-doc-helper search-endpoints orders
+uvx --from mcp-server-saxo-openapi saxo-doc-helper --version
+```
+
+CLI はパッケージ名と違うため `--from mcp-server-saxo-openapi` が必要です。
+
+MCP 設定例:
+
+```json
+{
+  "mcpServers": {
+    "saxo-openapi": {
+      "command": "uvx",
+      "args": ["mcp-server-saxo-openapi"]
+    }
+  }
+}
+```
+
+### GitHub から
+
+```bash
+uvx --from git+https://github.com/nohikomiso/mcp-server-saxo-openapi.git saxo-doc-helper search-endpoints orders
+```
+
+### TestPyPI（開発用）
+
+```bash
+uvx --index-url https://test.pypi.org/simple/ \
+    --index https://pypi.org/simple/ \
+    --from mcp-server-saxo-openapi \
+    saxo-doc-helper search-endpoints orders
+```
+
+---
+
+## はじめに — ローカル clone
+
+```bash
+git clone https://github.com/nohikomiso/mcp-server-saxo-openapi.git
+cd mcp-server-saxo-openapi
+python tools/saxo_doc_helper.py search-endpoints orders
+```
+
+または:
+
+```bash
+uv sync
+uv run saxo-doc-helper --version
+```
+
+---
+
+## 公開 MCP ツール
+
+| ツール | 説明 |
+|--------|------|
+| `search_saxo_endpoints(query)` | 全エンドポイントをキーワード検索 |
+| `get_saxo_endpoint_spec(method, path, depth?)` | パラメータ + サンプル JSON |
+| `get_saxo_schema_spec(schema_name, depth?)` | ネストスキーマのドリルダウン |
+
+---
+
+## 関連プロジェクト
+
+| プロジェクト | 役割 |
+|--------------|------|
+| [saxo-apy](https://github.com/nohikomiso/saxo-apy) | OAuth / セッション |
+| [saxo-openapi](https://github.com/nohikomiso/saxo-openapi) | REST/WebSocket クライアント |
+| [@borgels/mcp-server-saxo](https://www.npmjs.com/package/@borgels/mcp-server-saxo) | ライブ Saxo OpenAPI MCP（npm・非公式） |
+
+本リポジトリは **仕様ルックアップ**。ランタイム API は別レイヤーです。
+
+---
+
+## フィードバック
+
+- 不具合・古い仕様: [GitHub Issues](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues)
+- メンテ: [docs/MAINTAINER.md](docs/MAINTAINER.md)
+
+---
+
+## License
+
+[MIT License](LICENSE)

mcp_server_saxo_openapi-0.1.1/README.md

@@ -0,0 +1,188 @@
+# mcp-server-saxo-openapi
+
+**Saxo Bank OpenAPI spec lookup — CLI tool and MCP server**
+
+English | [日本語](https://github.com/nohikomiso/mcp-server-saxo-openapi/blob/main/README.ja.md)
+
+---
+
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Python](https://img.shields.io/badge/python-3.10+-blue.svg)
+![CLI](https://img.shields.io/badge/CLI-saxo--doc--helper-blue.svg)
+![MCP](https://img.shields.io/badge/MCP-stdio-orange.svg)
+![Spec updated](https://img.shields.io/github/last-commit/nohikomiso/mcp-server-saxo-openapi/main?label=spec%20updated)
+
+Look up **Saxo Bank** / **Saxobank** OpenAPI endpoint parameters and JSON samples from your terminal, or attach the same tools to Cursor, Claude Desktop, and other MCP clients — without wrestling the deep official reference tree.
+
+Zero third-party dependencies (Python stdlib only). Spec database: ~260 endpoints across 17 service groups, shipped inside the wheel.
+
+---
+
+## Spec snapshot
+
+**Spec snapshot: 2026-07-08** (Saxo Release Notes through **2025/05/15**).
+
+Structured endpoint specs for agents and developers. Saxo does not publish a single docs semver; we record the crawl date and the newest Release Notes heading present at that time. Details: [SPEC_FRESHNESS.md](SPEC_FRESHNESS.md).
+
+Missing endpoint, wrong parameter, or something that looks out of date? Please [open an Issue](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues). Pull requests: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## What this is / is not
+
+| This package | Not this package |
+|--------------|------------------|
+| Offline **spec lookup** (CLI + MCP) | Live trading / portfolio API calls |
+| No Saxo credentials required | OAuth, order placement, balances |
+| Token-efficient progressive disclosure | A substitute for a full OpenAPI client |
+
+For **live** Saxo OpenAPI access from an MCP client, see community servers such as [`@borgels/mcp-server-saxo`](https://www.npmjs.com/package/@borgels/mcp-server-saxo) (npm, unofficial, separate project).
+
+**Unofficial** — not affiliated with or endorsed by Saxo Bank A/S.
+
+---
+
+## Features
+
+- **Structured spec database** — nested parameters and request/response samples
+- **CLI** — `search-endpoints`, `get-endpoint`, `get-schema` with depth control and "Did you mean?" suggestions
+- **MCP server** — stdio JSON-RPC; same three tools
+- **Token-efficient** — progressive disclosure (collapsed nested schemas, drill down on demand)
+
+**Requirements:** Python 3.10+
+
+---
+
+## Getting started — recommended (uvx)
+
+### Production PyPI
+
+```bash
+uvx mcp-server-saxo-openapi
+uvx --from mcp-server-saxo-openapi saxo-doc-helper search-endpoints orders
+uvx --from mcp-server-saxo-openapi saxo-doc-helper --version
+```
+
+`uvx` resolves the **package** name; use `--from mcp-server-saxo-openapi` to run the `saxo-doc-helper` console script.
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "saxo-openapi": {
+      "command": "uvx",
+      "args": ["mcp-server-saxo-openapi"]
+    }
+  }
+}
+```
+
+### From GitHub
+
+```bash
+uvx --from git+https://github.com/nohikomiso/mcp-server-saxo-openapi.git saxo-doc-helper search-endpoints orders
+uvx --from git+https://github.com/nohikomiso/mcp-server-saxo-openapi.git mcp-server-saxo-openapi
+```
+
+### TestPyPI (development only)
+
+```bash
+uvx --index-url https://test.pypi.org/simple/ \
+    --index https://pypi.org/simple/ \
+    --from mcp-server-saxo-openapi \
+    saxo-doc-helper search-endpoints orders
+```
+
+---
+
+## Getting started — local clone
+
+```bash
+git clone https://github.com/nohikomiso/mcp-server-saxo-openapi.git
+cd mcp-server-saxo-openapi
+python tools/saxo_doc_helper.py search-endpoints orders
+python tools/saxo_doc_helper.py get-endpoint POST /trade/v2/orders
+python tools/saxo_doc_helper.py get-schema algorithmicorderdata
+```
+
+Or install editable:
+
+```bash
+uv sync
+uv run saxo-doc-helper --version
+uv run saxo-doc-helper search-endpoints orders
+```
+
+### Input normalization
+
+| Input | Normalized |
+|-------|------------|
+| `post` | `POST` |
+| `trade/v2/orders` | `/trade/v2/orders` |
+| `https://gateway.saxobank.com/sim/openapi/trade/v2/orders` | `/trade/v2/orders` |
+
+If no exact match is found, **Did you mean?** suggestions are returned.
+
+---
+
+## MCP tools exposed
+
+| Tool | Description |
+|------|-------------|
+| `search_saxo_endpoints(query)` | Keyword search across all endpoints |
+| `get_saxo_endpoint_spec(method, path, depth?)` | Parameters + request/response samples |
+| `get_saxo_schema_spec(schema_name, depth?)` | Nested schema drill-down |
+
+---
+
+## Agent integration
+
+> When researching Saxo OpenAPI specs, do **not** read `spec/json/` files directly.  
+> Use `saxo-doc-helper` (or `python tools/saxo_doc_helper.py` from a clone).
+
+---
+
+## Repository layout
+
+```text
+mcp-server-saxo-openapi/
+├── pyproject.toml
+├── SPEC_FRESHNESS.md
+├── LICENSE
+├── README.md / README.ja.md
+├── CONTRIBUTING.md
+├── docs/
+│   └── MAINTAINER.md
+├── src/saxo_doc_helper/   # installable package (+ data/json)
+├── spec/json/             # maintainer source of truth
+├── tests/
+└── tools/
+    └── saxo_doc_helper.py # thin clone-compatible wrapper
+```
+
+---
+
+## Related projects
+
+| Project | Role |
+|---------|------|
+| [saxo-apy](https://github.com/nohikomiso/saxo-apy) | OAuth and session management |
+| [saxo-openapi](https://github.com/nohikomiso/saxo-openapi) | Python REST/WebSocket client (AI-ready) |
+| [@borgels/mcp-server-saxo](https://www.npmjs.com/package/@borgels/mcp-server-saxo) | Live Saxo OpenAPI MCP (npm; unofficial) |
+
+This repository provides **spec lookup**. Runtime API access is a separate concern.
+
+---
+
+## Feedback and maintainers
+
+- Bugs / stale specs: [GitHub Issues](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues)
+- Maintainers: [docs/MAINTAINER.md](docs/MAINTAINER.md)
+- Source crawl: public Saxo Developer Portal reference docs
+
+---
+
+## License
+
+[MIT License](LICENSE)

mcp_server_saxo_openapi-0.1.1/SPEC_FRESHNESS.md

@@ -0,0 +1,26 @@
+# Spec freshness
+
+| Field | Value |
+|-------|-------|
+| **Spec snapshot** | `2026-07-08` |
+| **Saxo Release Notes through** | `2025/05/15` |
+| Package version | `0.1.1` (tool/PyPI version; independent of the snapshot dates) |
+
+There is **no single semver** for the whole Saxo OpenAPI documentation set. Saxo publishes dated [Release Notes](https://www.developer.saxo/openapi/releasenotes/release-notes) (e.g. `Release 2025/05/15`). Endpoint paths may contain `v1`/`v2` — those are per-service API versions, not a global docs version.
+
+## What the dates mean
+
+- **Spec snapshot** — the day this repository’s structured `spec/json/` was crawled/synced from the Saxo Developer Portal.
+- **Saxo Release Notes through** — the newest Release Notes heading present on the portal when that snapshot was taken.
+
+## Source
+
+- Reference docs: https://www.developer.saxo/openapi/referencedocs
+- Release notes: https://www.developer.saxo/openapi/releasenotes
+- Planned changes: https://www.developer.saxo/openapi/releasenotes/planned-changes
+
+Maintainers detect portal updates by hashing the Release Notes and Planned Changes pages (see the private workspace crawler `check_change_detection`), then re-crawl, update this file, sync package data, and publish a new package version.
+
+## Feedback
+
+Missing endpoint, wrong parameter, or something that looks out of date? Please [open an Issue](https://github.com/nohikomiso/mcp-server-saxo-openapi/issues).