From cf2fd3779f1e677f254badac77943a8bcf342ced Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 10 Sep 2026 08:47:42 +0000 Subject: [PATCH 1/2] docs: retire the hosted Railway instance from the README The public hosted instance (Railway) has been shut down (cost). Replace the "Hosted instance (recommended)" quick start with a notice that it is no longer available, lead with npx (stdio) as the zero-install path, and switch the url-based MCP config and REST examples to a placeholder. All other usage methods (npx, native executable, Docker, Node host, SAP BTP) are unchanged. Note in the skills list that the previously hosted-wired skill needs a base URL set. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01GtasV9bcxrPwJP1Vx2tncm --- README.md | 39 ++++++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 09c377e..e5f5618 100644 --- a/README.md +++ b/README.md @@ -23,34 +23,37 @@ business logic — no feature gap between them: > Ask *"Is table MARA available in ABAP Cloud?"* and the agent instantly knows: > **no — use `I_PRODUCT` instead.** -## Quick start — Hosted instance (recommended) +## Quick start -ROSA is publicly hosted — no install, no server to run. Connect your AI agent -directly: +> **The previously hosted public instance (on Railway) has been retired** — it +> was too costly to keep running. There is **no default public URL** anymore. +> Everything else still works: run ROSA via `npx`, a native executable, Docker, +> any Node host, or SAP BTP — see the deployment options below. -### MCP (Claude Desktop, Claude Code, Cursor, Cline…) - -**Claude Code** (`.mcp.json`) / **Claude Desktop** (`claude_desktop_config.json`): +The quickest path is **npx** — no install, runs in stdio mode (what MCP clients +expect). Add this to your client config (Claude Code `.mcp.json`, Claude Desktop +`claude_desktop_config.json`, or Cursor `~/.cursor/mcp.json`): ```json { "mcpServers": { "rosa": { - "type": "url", - "url": "https://sap-released-objects-server-production.up.railway.app/mcp" + "command": "npx", + "args": ["-y", "@rosa-mcp/server"] } } } ``` -**Cursor** (`~/.cursor/mcp.json` or `.cursor/mcp.json`): +Already running ROSA somewhere (self-hosted / your own server)? Point your client +at its URL instead: ```json { "mcpServers": { "rosa": { "type": "url", - "url": "https://sap-released-objects-server-production.up.railway.app/mcp" + "url": "https:///mcp" } } } @@ -58,18 +61,20 @@ directly: ### REST API -All endpoints are `GET`, return JSON, and support CORS: +All endpoints are `GET`, return JSON, and support CORS (replace `` +with your own host): ```bash -curl "https://sap-released-objects-server-production.up.railway.app/api/search?query=purchase+order" -curl "https://sap-released-objects-server-production.up.railway.app/api/object?object_type=TABL&object_name=MARA" -curl "https://sap-released-objects-server-production.up.railway.app/api/compliance?object_names=MARA,BSEG,I_PRODUCT" +curl "https:///api/search?query=purchase+order" +curl "https:///api/object?object_type=TABL&object_name=MARA" +curl "https:///api/compliance?object_names=MARA,BSEG,I_PRODUCT" ``` -For LLM-skill usage, two ready-made skills expose the full API reference: +For LLM-skill usage, the full API reference is available as a skill you point at +your instance: -- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — points at the hosted public instance; use as-is. -- [`skills/rosa-global/SKILL.md`](./skills/rosa-global/SKILL.md) — for your **own self-hosted** deployment: copy it and replace the `{{ROSA_BASE_URL}}` placeholder with your instance URL. +- [`skills/rosa-global/SKILL.md`](./skills/rosa-global/SKILL.md) — copy it and replace the `{{ROSA_BASE_URL}}` placeholder with your instance URL. +- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — the same reference; note it was wired to the now-retired hosted URL, so set the base URL before use. --- From 5991df045da6a36c3d201c6f6ef7a205fa9467ef Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 10 Sep 2026 08:50:31 +0000 Subject: [PATCH 2/2] docs(skill): mark the hosted-instance skill obsolete The Railway-hosted instance this skill targeted has been retired. Keep the file for reference but mark it OBSOLETE: frontmatter name/description, a banner pointing to skills/rosa-global, and a dead-endpoint note by the base URL. Update the README skills list accordingly. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01GtasV9bcxrPwJP1Vx2tncm --- README.md | 2 +- skills/sap-released-objects/SKILL.md | 11 +++++++++-- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index e5f5618..c3fc7ff 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,7 @@ For LLM-skill usage, the full API reference is available as a skill you point at your instance: - [`skills/rosa-global/SKILL.md`](./skills/rosa-global/SKILL.md) — copy it and replace the `{{ROSA_BASE_URL}}` placeholder with your instance URL. -- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — the same reference; note it was wired to the now-retired hosted URL, so set the base URL before use. +- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — **obsolete** (was wired to the retired hosted instance); kept for reference only. --- diff --git a/skills/sap-released-objects/SKILL.md b/skills/sap-released-objects/SKILL.md index 8346582..3743587 100644 --- a/skills/sap-released-objects/SKILL.md +++ b/skills/sap-released-objects/SKILL.md @@ -1,16 +1,23 @@ --- -name: ROSA — Released Objects Search Assistant -description: This API queries the SAP Cloudification Repository — the official source of truth for which SAP objects are released, deprecated, or forbidden in ABAP Cloud / Clean Core. It answers questions regarding object status, successors (e.g., MARA → I_PRODUCT), and Clean Core compliance. +name: ROSA — Released Objects Search Assistant (OBSOLETE) +description: "[OBSOLETE — the hosted instance this skill targeted has been retired; use skills/rosa-global instead.] This API queries the SAP Cloudification Repository — the official source of truth for which SAP objects are released, deprecated, or forbidden in ABAP Cloud / Clean Core. It answers questions regarding object status, successors (e.g., MARA → I_PRODUCT), and Clean Core compliance." --- # Skill Instructions +> ⚠️ **OBSOLETE — do not use as-is.** The hosted instance this skill targeted (on +> Railway) has been retired, so the base URL below no longer responds. Kept for +> reference only. Use [`../rosa-global/SKILL.md`](../rosa-global/SKILL.md) +> instead and set your own `{{ROSA_BASE_URL}}`. + ## Base URL ``` https://sap-released-objects-server-production.up.railway.app ``` +> This endpoint is no longer available (see the obsolete notice above). + All endpoints return JSON. All parameters are passed as query string. All endpoints support CORS. ## Common Parameters