mcp-server-saxo-openapi 0.1.1__py3-none-any.whl

mcp_server_saxo_openapi-0.1.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,97 @@
+saxo_doc_helper/__init__.py,sha256=jgAACGnHmifW1pM2gySGgI3lqy2TiLlkRus75fFcfXY,698
+saxo_doc_helper/__main__.py,sha256=LtnpzKxHY-8E9Uh-yHKZnEtAZC6PJB7OxH5MD0ZUE4U,120
+saxo_doc_helper/cli.py,sha256=bhF8iNx1EsG0lNKRSAaInmEild5JEAv6GwVYNvQk6fY,2924
+saxo_doc_helper/commands.py,sha256=CK4OifhnsGmxXlI6uOxiyYqBh7XKoOJ-VpzKF1yLIl8,4173
+saxo_doc_helper/index.py,sha256=c1W1zNlRb57fBsrkCYOIQSfUnz8pMQjV7lBQDjUhls0,5218
+saxo_doc_helper/mcp_server.py,sha256=nWD2PVr-GjWesSb24xpKwRmpKhOmYkbcjnPtUNT5JFk,5070
+saxo_doc_helper/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+saxo_doc_helper/data/__init__.py,sha256=akk-TI8vMzEAQ91pbrj5o9ZCQIHAPy4-k6G7vBvORD0,58
+saxo_doc_helper/data/json/atr/cashmanagement-beneficiaryinstructions.json,sha256=NIsKFEEDKQIFumFuUJM6m9WCQnCpDfWfOCrpuTG9PN4,2680
+saxo_doc_helper/data/json/atr/cashmanagement-cashwithdrawal.json,sha256=cUVSyLzFCZpu0hwIQHtgvsVwk04hpb4WCjKpnwGLa3w,2675
+saxo_doc_helper/data/json/atr/cashmanagement-cashwithdrawallimits.json,sha256=2ZOqXFW3x1Y9y-NItacdsSozah5wKZf6sUeJxCX0KzA,1947
+saxo_doc_helper/data/json/atr/cashmanagement-interaccounttransfers.json,sha256=xYypjh-7l7gXTG1o8pOpDu73gXDg0Oiec1SQxN36yt0,1611
+saxo_doc_helper/data/json/atr/cashmanagement-periodicpayment.json,sha256=D5l2q1XWRYpoa96i4pLvmbdVegXoR3BZCv_budO5R8Y,12634
+saxo_doc_helper/data/json/atr/partner-cashtransfer.json,sha256=h4lf0qRgEPhSs45WJdTd_Yz6SzfvqqJvdzqMl7Uut7Q,8843
+saxo_doc_helper/data/json/atr/partner-cashtransferlimits.json,sha256=bLi-ZFnDmmRwx_HWeC0vxtguZXTMxjFgu-LWUXeU3QA,1879
+saxo_doc_helper/data/json/atr/partner-prefunding.json,sha256=NEO3zx9G0nJyqAs20TJT01MG8Z9cJUtWS4bj54nUwd0,3117
+saxo_doc_helper/data/json/atr/securitiestransfers.json,sha256=5lQmKGFwqKcWhYzCy3VxWBtLyAVu6NAIKX-8X0l7SR4,40835
+saxo_doc_helper/data/json/ca/elections.json,sha256=qPR7LWpZF2K8OKJaZZpOfqKFyDCfmMEG_856BstquHc,4540
+saxo_doc_helper/data/json/ca/events.json,sha256=Uc_FB7hEkAna0DslwB27DF7MNjD31lP9vGd1JbeZ2qs,56805
+saxo_doc_helper/data/json/ca/eventviews.json,sha256=hJYXhfgpQaZmbHCSf-L6hHMEs2bGyiEZkV_G3B6DI9Y,34603
+saxo_doc_helper/data/json/ca/holdings.json,sha256=cAjKpTgMLgSSJV-mPqFg27pMQ7lgZ1jTsxSxSuQIQtE,8556
+saxo_doc_helper/data/json/ca/proxyvoting.json,sha256=zeXhuUAcLInxAg4tsaUvJKJnLE5MaaAJ7ySMZc7MSFE,10462
+saxo_doc_helper/data/json/ca/standinginstructions.json,sha256=4qnTUC6HbUw1LpI_95X7Xcj9EtGZ7iSnyso5CuMa7I4,14460
+saxo_doc_helper/data/json/chart/charts.json,sha256=EZVWb0lqk9ujoQVzHbPeX1sy80nIqI52NxbmU7Wm1O4,69680
+saxo_doc_helper/data/json/cm/accounts.json,sha256=mUWHRjYC2OtmHBeZXaupLiv786R2JsBBUftujQdlBL8,1160
+saxo_doc_helper/data/json/cm/clientrenewals.json,sha256=wkLw2dF-9QVyssRaSDyaE_SvkRoVm95x5hUQcVE8bEc,121956
+saxo_doc_helper/data/json/cm/documents.json,sha256=oBfdkX4N3kDMjmcT6HGwPn12Z3jOQBQQpd9_Q1LZTL0,3704
+saxo_doc_helper/data/json/cm/signups.json,sha256=4ARUo3I_hPr7ORYFdtj_ANDjDJmwPtwVJ6R8gn90wBg,21788
+saxo_doc_helper/data/json/cm/users.json,sha256=Fg7XmGmdGbA3LZ3dLGW_k8gZwxum3EYDkQjJVVq59yA,1299
+saxo_doc_helper/data/json/cr/historicalreportdata-accountstatement.json,sha256=fbwNQ-YcB4rlz7HcgV7XB2XRErpSACDk5EaBHEle6Ic,2803
+saxo_doc_helper/data/json/cr/historicalreportdata-portfoliomanagement.json,sha256=NaC9SL1cfxISxt0ObbSQra_5BO9xbTxSpWOvbzTidws,4873
+saxo_doc_helper/data/json/cr/historicalreportdata-tradedetails.json,sha256=to-FjuSXM1Cm2F8-fnkqZ0q3tId7F4yqeTx3yUGiCSw,2567
+saxo_doc_helper/data/json/cr/historicalreportdata-tradesexecuted.json,sha256=H0rs31KnM4PrUL4m-fnv1f70X-SE5EJyvb9z43xqFv4,2133
+saxo_doc_helper/data/json/cs/audit-orderactivities.json,sha256=CScmK654B60lIT_fjkoY5v0TE1cC3dfyq-EwxeLfFEo,9002
+saxo_doc_helper/data/json/cs/cashmanagement-interaccounttransfer.json,sha256=erGyWtA2foECdB3G6CkGxnKKi2lpAFdqmfoIz2cZri4,1942
+saxo_doc_helper/data/json/cs/cashmanagement-wiretransfers.json,sha256=Ac8FSOBBBsvcd350cw0pCqeM_1aLkTaBVjtKA0nZqu0,2127
+saxo_doc_helper/data/json/cs/clientinfo.json,sha256=_tcDCnvAa59EW7mABs00jUNeVDxn_vg_znKZGYzaAxU,5256
+saxo_doc_helper/data/json/cs/historicalreportdata-aggregatedamounts.json,sha256=P86S3VlFTe5tmNW2mYfkeJNoVUVT-4jekXAGhsybCl8,5168
+saxo_doc_helper/data/json/cs/historicalreportdata-bookings.json,sha256=kRPk9jMhLq-nIUYRKAt_kaHepc3qcmiKqoB2QLjj51Y,9387
+saxo_doc_helper/data/json/cs/historicalreportdata-closedpositions.json,sha256=gtgsXRc6sjwYuoEkETCkSRFOS_TmyGEzHHTM7W2zMvA,3977
+saxo_doc_helper/data/json/cs/historicalreportdata-trades.json,sha256=v6jdWuJ_KajVEc9HpTOBtJiJEqytNGjH-vcqcGlACZ8,4653
+saxo_doc_helper/data/json/cs/support-cases.json,sha256=wX46VGtV38lU_jF7agnIJ1TTjiJXz3aLJ-XupoStkG4,17378
+saxo_doc_helper/data/json/cs/tradingconditions-contractoption.json,sha256=HSt_0z3WMMPMXyelLYYCHfd92D2ab7izItyndk8l2rg,3904
+saxo_doc_helper/data/json/cs/tradingconditions-cost.json,sha256=G_ZSHduuCgBwn-hGitIG7Q69ZPx7JVFAh6SAmVTCVow,34163
+saxo_doc_helper/data/json/cs/tradingconditions.json,sha256=0eie6MnB50TK_cu43QpURIcuaBTCWJ-PEXMuURYw71g,33629
+saxo_doc_helper/data/json/dm/disclaimermanagement.json,sha256=Zbz09kxb39DnCcj0K_001t9x5-UzDAaDt55iJgdPdiY,4087
+saxo_doc_helper/data/json/ens/clientactivities.json,sha256=bUA9yYCIiyz3t1VIsU7VubB8dOU3TvhtLeoQBRBiotA,56968
+saxo_doc_helper/data/json/hist/accountvalues.json,sha256=KV-eK4eF6HDtMiO9Ta36gMZjN3YhvZkui8rwcROdpBM,1673
+saxo_doc_helper/data/json/hist/historicalpositions.json,sha256=RX69wVgPkZY6YaqfIsiw3yGJmz5om65tAQy7jDXpCDU,31230
+saxo_doc_helper/data/json/hist/performance.json,sha256=JPDeWjAOc5i7cMNOC01Un2VzjawMGnlj2kMIwLALLUM,32486
+saxo_doc_helper/data/json/hist/transactions.json,sha256=fEue4etjGleRqC1Fb59e6Da1uhIhrMySq_XuhRZfmvM,12508
+saxo_doc_helper/data/json/hist/unsettledamounts.json,sha256=8Sgano8cIhYkzFNWr1XGIXUBLi6zfByLUdZw0aKJBKc,16232
+saxo_doc_helper/data/json/mkt/instrumentdocument.json,sha256=JKARdIGgTrAhHfQK6OUrwp_KpM0VPNNB2wif6WXesF0,58337
+saxo_doc_helper/data/json/partnerintegration/advisoryaccounts.json,sha256=R3LbafiZqgQR_geh7YwjuYU6ndp8rR74AJdkoI1aA8s,14990
+saxo_doc_helper/data/json/partnerintegration/externalaccounts.json,sha256=WSQzmDPoMjmTZUPyahPLAcKxmxjbLduu3e9Mp7TqQ6I,24166
+saxo_doc_helper/data/json/partnerintegration/fundinginstruction.json,sha256=ZcJDIdyuHBp59cyLu7TWvGUWY9cYz4UWkNTJP6KYZ10,9454
+saxo_doc_helper/data/json/partnerintegration/interactiveesigning.json,sha256=YzHJMwmExEHRCP_Um5JOQ61cUGE6AJA3e67KYPJziZ8,8043
+saxo_doc_helper/data/json/partnerintegration/interactiveidverification.json,sha256=wrRnlZmFSUfJKzVM0lGovhQGFs-ieQqgFg5ABix2fQ8,7839
+saxo_doc_helper/data/json/partnerintegration/partnerbulkbookings.json,sha256=MWxSxj20ioYMrEVjRT5p0Sti1z1nOk7F1_Mb0u6xJLw,2638
+saxo_doc_helper/data/json/partnerintegration/updatepricing.json,sha256=GKxg9YlgaJ5kUjK6fXpGr8Z7Q6Cz23quFa0EgQiEHXg,30372
+saxo_doc_helper/data/json/port/accountgroups.json,sha256=q6bdllOVQhbhhzfeAmPx8z-lBwWnqW1DLp6uXWfcJPY,6833
+saxo_doc_helper/data/json/port/accounts.json,sha256=kQz5QzX4jHLPUCXd1aDZwyr1y1ZDQOCq14q6HZh1Dew,44562
+saxo_doc_helper/data/json/port/balances.json,sha256=6pubwQ02nyfGDrAJQH3EVqHv2kysJFxRON7SlZ1MDq4,151500
+saxo_doc_helper/data/json/port/clients.json,sha256=pjd67drLipy9VB_UOBG46oRead6T6HBoq7fP9X0LuOE,53783
+saxo_doc_helper/data/json/port/closedpositions.json,sha256=rt5DnLNnVny07WzdvMNesd7YdYekMRVl9ypAx9RuJW8,23193
+saxo_doc_helper/data/json/port/exposure.json,sha256=JjdhsEtgUpVu1IcmHKPZ_xVJj1LyedK1g2rdO0NCzm8,121480
+saxo_doc_helper/data/json/port/netpositions.json,sha256=3v0Kwl0k5krVqMXCNl6m9p-cjUXgvdWtx-iXqTmuIY4,82634
+saxo_doc_helper/data/json/port/orders.json,sha256=mZ14pqh3w8aDH-kwMY9ftLRROnbNmzPQfhZ0zfpAgK0,24706
+saxo_doc_helper/data/json/port/positions.json,sha256=-7SOXFNQzpz31Yyg9arjUtOg3enoab4Wk0ZDHSnH5AQ,30559
+saxo_doc_helper/data/json/port/users.json,sha256=lcvCfJqIJHuflnnZbk0tHSIjhaOxQOZtIiGGWfgSsik,38556
+saxo_doc_helper/data/json/ref/algostrategies.json,sha256=ZhRH9V8dpj6r7QHFGSwvVFT4CsHIXWZb9pYMppA21n0,2898
+saxo_doc_helper/data/json/ref/countries.json,sha256=-N54qPyW1GBljwPX64r5qX4M_XvAzcl_BDtsGwG6pa0,6382
+saxo_doc_helper/data/json/ref/cultures.json,sha256=AiU1CzKB63CnbFcQf0_bH7SVUfeM5EakatJ6ZYu8CY0,2207
+saxo_doc_helper/data/json/ref/currencies.json,sha256=oLUlQnBiIKPI7FwgPjpSR6zl80FHtxXnS4ZO8_zmrs8,2665
+saxo_doc_helper/data/json/ref/currencypairs.json,sha256=wm4--ZMgfxAlh5L3f1ywvao_PashMoNyjdJbjSd5L1w,2101
+saxo_doc_helper/data/json/ref/exchanges.json,sha256=nf_Une7xoIlvI9mXU6gBeSXhkl08O5wkByOsoAkamZo,2204
+saxo_doc_helper/data/json/ref/instruments.json,sha256=RqhecpyEf4h7Oo4z-V0Efav9CACvYu6z403xEsdMyBw,132970
+saxo_doc_helper/data/json/ref/languages.json,sha256=wEGssgj6JyMgp6VaqFNJOar4r0GRbowXJ6MTRnzNzqw,2619
+saxo_doc_helper/data/json/ref/standarddates.json,sha256=RRtNG7l_iblldgS2HES3FXZHLWaYgks-h9dMlY6VRnw,2011
+saxo_doc_helper/data/json/ref/timezones.json,sha256=8YMukXNSGzFp3WY7ahHhjHtYQGvvhBe3b9vLPgscJNU,3969
+saxo_doc_helper/data/json/reg/financialoverview.json,sha256=IP6YBAdnjOqpyQW8Q23ZDaPSPrNI6c6fDAXeXPx7faI,15645
+saxo_doc_helper/data/json/reg/investmentprofile.json,sha256=TpUnpOAIpuhYdDOma85Op5bAtkzsW9cLtCE7gXpK8hk,32023
+saxo_doc_helper/data/json/reg/knowledgeandexperience.json,sha256=aHqTGu-HHdGDPSH47jrRKn-sb-OBGcIFRGwxPSxIHRM,4390
+saxo_doc_helper/data/json/trade/allocationkeys.json,sha256=Em_eZ-_o5DhtOJwwF1ZGzAAwvzx8SJnvS_qMnH2mApI,40244
+saxo_doc_helper/data/json/trade/infoprices.json,sha256=KaJLwwGoK_JEHv_iL-zx48ftSTmRW5eXso0t29E3huo,109859
+saxo_doc_helper/data/json/trade/messages.json,sha256=njZ0gP0Kg4hIun6Nbq0gAuQwzZ0IgRPtw5-qk6ciDvg,13341
+saxo_doc_helper/data/json/trade/optionschain.json,sha256=T-yrA7q2txgrw7VHoBRkZ3XSqn7GckKBKJFwZU1Ioxw,47487
+saxo_doc_helper/data/json/trade/orders.json,sha256=eiBgEbbt5H9dhEr4mBl9PawOTxqdNtlfDxTjveXKOLU,396941
+saxo_doc_helper/data/json/trade/positions.json,sha256=2JGdfwp6HnMmIa51jyJ25tHlFgKSihfoqml_-PY4nJE,54533
+saxo_doc_helper/data/json/trade/prices.json,sha256=jO3Pk1VTJipJWTeTSBKAQmqe76xPfnQmHugneS1Rs4o,127465
+saxo_doc_helper/data/json/trade/trades.json,sha256=JX2Ie20bE0owWuid75buoyqbit7Sxya--Tz9rdr8cYY,36142
+saxo_doc_helper/data/json/vas/pricealerts.json,sha256=VDuknIGAUJa8A-PWCeIx1VA2uB7vHRTE99oAMyJ__Yg,73789
+mcp_server_saxo_openapi-0.1.1.dist-info/METADATA,sha256=4Fe-f6clAQlD8c6oZ8m8X11dME1V3S6ULVsFpk6ZN9E,7104
+mcp_server_saxo_openapi-0.1.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+mcp_server_saxo_openapi-0.1.1.dist-info/entry_points.txt,sha256=YSgs4xx7gQ1lBTH3cd6rg5OAsrlOIpIB5-ek-mtFM_w,116
+mcp_server_saxo_openapi-0.1.1.dist-info/licenses/LICENSE,sha256=_HRu5kqPvkdh0yNADHdfHiBRiCyUAwHOm8Fk8VJYxy4,1067
+mcp_server_saxo_openapi-0.1.1.dist-info/RECORD,,

mcp_server_saxo_openapi-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mcp_server_saxo_openapi-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+mcp-server-saxo-openapi = saxo_doc_helper.cli:mcp_main
+saxo-doc-helper = saxo_doc_helper.cli:main

mcp_server_saxo_openapi-0.1.1.dist-info/licenses/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.

saxo_doc_helper/__init__.py

@@ -0,0 +1,32 @@
+"""Saxo OpenAPI spec lookup — CLI and MCP server."""
+
+__version__ = "0.1.1"
+SPEC_SNAPSHOT_DATE = "2026-07-08"
+SAXO_RELEASE_NOTES_THROUGH = "2025/05/15"
+
+from saxo_doc_helper.index import (
+    SaxoDocIndex,
+    normalize_method,
+    normalize_path,
+    normalize_schema_name,
+    resolve_spec_dir,
+)
+from saxo_doc_helper.commands import (
+    cmd_get_endpoint,
+    cmd_get_schema,
+    cmd_search_endpoints,
+)
+
+__all__ = [
+    "SAXO_RELEASE_NOTES_THROUGH",
+    "SPEC_SNAPSHOT_DATE",
+    "SaxoDocIndex",
+    "__version__",
+    "cmd_get_endpoint",
+    "cmd_get_schema",
+    "cmd_search_endpoints",
+    "normalize_method",
+    "normalize_path",
+    "normalize_schema_name",
+    "resolve_spec_dir",
+]

saxo_doc_helper/__main__.py

@@ -0,0 +1,6 @@
+"""Allow ``python -m saxo_doc_helper``."""
+
+from saxo_doc_helper.cli import main
+
+if __name__ == "__main__":
+    main()

saxo_doc_helper/cli.py

@@ -0,0 +1,95 @@
+"""CLI and MCP entry points."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from saxo_doc_helper import (
+    SAXO_RELEASE_NOTES_THROUGH,
+    SPEC_SNAPSHOT_DATE,
+    __version__,
+)
+from saxo_doc_helper.commands import cmd_get_endpoint, cmd_get_schema, cmd_search_endpoints
+from saxo_doc_helper.index import SaxoDocIndex, resolve_spec_dir
+from saxo_doc_helper.mcp_server import run_mcp_server
+
+
+def version_string() -> str:
+    return (
+        f"mcp-server-saxo-openapi {__version__} "
+        f"(spec snapshot {SPEC_SNAPSHOT_DATE}; "
+        f"saxo RN through {SAXO_RELEASE_NOTES_THROUGH})"
+    )
+
+
+def mcp_main() -> None:
+    """Entry point for ``mcp-server-saxo-openapi`` (stdio MCP only)."""
+    index = SaxoDocIndex(resolve_spec_dir())
+    run_mcp_server(index)
+
+
+def main(argv: list[str] | None = None) -> None:
+    """Entry point for ``saxo-doc-helper`` and ``python -m saxo_doc_helper``."""
+    parser = argparse.ArgumentParser(
+        description="Saxo OpenAPI spec lookup — CLI & MCP helper",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  saxo-doc-helper search-endpoints orders
+  saxo-doc-helper get-endpoint POST /trade/v2/orders
+  saxo-doc-helper get-endpoint post trade/v2/orders --depth 1
+  saxo-doc-helper get-schema algorithmicorderdata
+  saxo-doc-helper --mcp
+  mcp-server-saxo-openapi
+        """,
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=version_string(),
+    )
+    parser.add_argument("--mcp", action="store_true", help="Run as MCP stdio server")
+    parser.add_argument(
+        "command",
+        nargs="?",
+        choices=["search-endpoints", "get-endpoint", "get-schema"],
+        help="CLI command to run",
+    )
+    parser.add_argument("args", nargs=argparse.REMAINDER, help="Command arguments")
+
+    parsed = parser.parse_args(argv)
+    index = SaxoDocIndex(resolve_spec_dir())
+
+    if parsed.mcp:
+        run_mcp_server(index)
+        return
+
+    if not parsed.command:
+        parser.print_help()
+        sys.exit(1)
+
+    if parsed.command == "search-endpoints":
+        if not parsed.args:
+            print("Usage: search-endpoints <query>")
+            sys.exit(1)
+        print(cmd_search_endpoints(index, " ".join(parsed.args)))
+
+    elif parsed.command == "get-endpoint":
+        sub = argparse.ArgumentParser()
+        sub.add_argument("method")
+        sub.add_argument("path")
+        sub.add_argument("--depth", type=int, default=0)
+        a = sub.parse_args(parsed.args)
+        print(cmd_get_endpoint(index, a.method, a.path, a.depth))
+
+    elif parsed.command == "get-schema":
+        sub = argparse.ArgumentParser()
+        sub.add_argument("schema_name")
+        sub.add_argument("--depth", type=int, default=0)
+        a = sub.parse_args(parsed.args)
+        print(cmd_get_schema(index, a.schema_name, a.depth))
+
+
+if __name__ == "__main__":
+    main()

saxo_doc_helper/commands.py

@@ -0,0 +1,119 @@
+"""CLI command implementations for Saxo OpenAPI spec lookup."""
+
+from __future__ import annotations
+
+import json
+
+from saxo_doc_helper.index import SaxoDocIndex, normalize_method, normalize_path, normalize_schema_name
+
+
+def _format_params(params: list, depth: int = 0, max_depth: int = 0) -> list[str]:
+    lines = []
+    for p in params:
+        indent = "  " * depth
+        origin = f" ({p['origin']})" if p.get("origin") else ""
+        line = f"{indent}- **{p['name']}** (`{p['type']}`){origin}: {p.get('description', '')}"
+        lines.append(line)
+
+        children = p.get("children", [])
+        if children:
+            link = p.get("link") or ""
+            schema_key = (
+                normalize_schema_name(link.split("/schema-")[-1]) if "/schema-" in link else ""
+            )
+            if depth < max_depth:
+                lines.extend(_format_params(children, depth + 1, max_depth))
+            else:
+                hint = f" [Refer to Schema: {schema_key}]" if schema_key else ""
+                lines.append(f"{indent}  * (Nested parameters collapsed.{hint})")
+    return lines
+
+
+def _render_json_sample(sample, label: str) -> str:
+    if sample is None:
+        return ""
+    if isinstance(sample, (dict, list)):
+        body = json.dumps(sample, indent=2, ensure_ascii=False)
+    else:
+        body = str(sample)
+    return f"\n{label}:\n{body}"
+
+
+def cmd_search_endpoints(index: SaxoDocIndex, query: str) -> str:
+    q = query.lower()
+    results = [
+        ep
+        for ep in index.endpoints
+        if q in ep["path"].lower()
+        or q in ep["name"].lower()
+        or q in ep["service"].lower()
+        or q in ep["category"].lower()
+    ]
+    if not results:
+        return f"No endpoints found matching '{query}'."
+    lines = [f"Found {len(results)} endpoint(s) matching '{query}':\n"]
+    for ep in results:
+        lines.append(
+            f"  [{ep['service']}/{ep['category']}] {ep['method']} {ep['path']} -> {ep['name']}"
+        )
+    return "\n".join(lines)
+
+
+def cmd_get_endpoint(index: SaxoDocIndex, method: str, path: str, depth: int = 0) -> str:
+    method = normalize_method(method)
+    path = normalize_path(path)
+
+    match = next(
+        (ep for ep in index.endpoints if ep["method"] == method and ep["path"] == path),
+        None,
+    )
+
+    if match is None:
+        candidates = [
+            ep for ep in index.endpoints if (path.rstrip("s") in ep["path"] or path in ep["path"])
+        ]
+        lines = [f'Error: Endpoint "{method} {path}" not found.']
+        if candidates:
+            lines.append("\nDid you mean one of these?")
+            for c in candidates[:5]:
+                lines.append(f"  - {c['method']} {c['path']}  ({c['name']})")
+        return "\n".join(lines)
+
+    param_lines = _format_params(match["parameters"], max_depth=depth)
+    out = [
+        f"Name: {match['name']}",
+        f"Path: {match['method']} {match['path']}",
+        f"URL:  {match['url']}",
+        "",
+        "Parameters:",
+    ]
+    out.extend(param_lines if param_lines else ["  (no parameters)"])
+    out.append(_render_json_sample(match["request_sample"], "Request Sample"))
+    out.append(_render_json_sample(match["response_sample"], "Response Sample"))
+    return "\n".join(out).strip()
+
+
+def cmd_get_schema(index: SaxoDocIndex, schema_name: str, depth: int = 0) -> str:
+    key = normalize_schema_name(schema_name)
+    schema = index.schemas.get(key)
+    if schema is None:
+        candidates = [k for k in index.schemas if key in k or k in key]
+        if candidates:
+            schema = index.schemas[candidates[0]]
+            key = candidates[0]
+        else:
+            available = sorted(index.schemas.keys())[:10]
+            return (
+                f'Error: Schema "{schema_name}" not found.\n'
+                f"Available schemas (first 10): {available}"
+            )
+
+    param_lines = _format_params(schema["parameters"], max_depth=depth)
+    out = [
+        f"Schema: {schema['type_name']} (key: {key})",
+        f"Description: {schema['description']}",
+        "",
+        "Parameters:",
+    ]
+    out.extend(param_lines if param_lines else ["  (no parameters)"])
+    return "\n".join(out)

saxo_doc_helper/data/__init__.py

@@ -0,0 +1 @@
+# Package data marker (JSON files live under data/json/).