standup-mr 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to standup-mr are recorded here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
 [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1] - 2026-09-02
+
+### Changed
+
+- `get_standup_data` documents itself properly. The description now gives the
+  shape of the object it returns, says the tool is a snapshot rather than a
+  search API and what that rules out, and spells out failure behaviour: a
+  rejected token, a refused resource or a rate limit surfaces the host's own
+  message after two retries on transient errors, and a blocker whose
+  diagnosis could not be fetched still comes back with `job: "unknown"`. The
+  parameter descriptions gained the interactions the schema cannot express —
+  `host` is required for GitLab and optional for GitHub, a recognisable host
+  settles `provider` on its own, and `lang` relabels dates without
+  translating anything.
+
 ## [0.4.0] - 2026-09-01
 
 ### Added

package/README.md

@@ -1,6 +1,7 @@
 # standup-mr
 
 [![standup-mr MCP server](https://glama.ai/mcp/servers/Jubstaaa/standup-mr/badges/score.svg)](https://glama.ai/mcp/servers/Jubstaaa/standup-mr)
+[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/jubstaaa/standup-mr)
 
 Standup notes from **merge request state**, not commit logs.
 

package/dist/mcp/server.js

@@ -1044,15 +1044,16 @@ async function collect(options = {}) {
   const provider = options.providerImpl ?? connect({ provider: options.provider, host: options.host, token: options.token });
   return buildReport(provider, /* @__PURE__ */ new Date(), options.lang ?? "en");
 }
+var STANDUP_TOOL_DESCRIPTION = 'Collect merge-request-based standup data from GitLab or GitHub. Returns one JSON object: `today`, `previousDays[]` with the events of each, `todayEvents[]`, `myMrs[]` bucketed ready / blocked / draft / stale, `reviews[]` waiting on you, and `blockers[]` carrying the error lines read out of each failed pipeline job log.\n\nCall it once at the start of a working day, to write a standup note. It is a snapshot, not a search API: it cannot fetch one named merge request, reach further back than the previous working day, or filter by project.\n\nRead-only, and credentials never come from an argument \u2014 they come from the environment or a logged-in gh / glab session. A rejected token, a refused resource or a rate limit fails the call with the host\'s own message, after two retries on transient server errors. A blocker whose diagnosis could not be fetched is still returned, with `job: "unknown"`, so a red pipeline is never silently dropped.';
 var STANDUP_TOOL_SCHEMA = {
   provider: z.enum(["github", "gitlab"]).optional().describe(
-    "Which provider to read. Omit to auto-detect, in this order: a recognisable host, STANDUP_PROVIDER, a GITHUB_*/GITLAB_* environment pair, then whichever of the gh / glab CLIs is logged in."
+    "Which provider to read. Omit to auto-detect, in this order: a recognisable host, STANDUP_PROVIDER, a GITHUB_*/GITLAB_* environment pair, then whichever of the gh / glab CLIs is logged in. Pass it when both are configured \u2014 ambiguity fails the call rather than being guessed at."
   ),
   host: z.string().optional().describe(
-    "Self-hosted host, without a scheme, e.g. gitlab.example.com or github.example.com. GitHub defaults to github.com; GitLab has no default, so self-hosted GitLab needs this or GITLAB_HOST."
+    "Self-hosted host, without a scheme, e.g. gitlab.example.com or github.example.com. Required for GitLab, which has no default host; optional for GitHub, which defaults to github.com. A recognisable host also settles `provider` on its own, so the two are rarely both needed."
   ),
   lang: z.enum(["en", "tr"]).optional().describe(
-    "Language for the date labels inside the returned JSON. Defaults to en. Only the labels change \u2014 the standup note itself is written by the caller."
+    "Language for the date labels inside the returned JSON: en (default) or tr. It relabels dates and nothing else \u2014 no field is translated, and the standup note itself is written by the caller, in whatever language they are speaking."
   )
 };
 async function runStandupTool(args, collector = collect) {
@@ -1067,7 +1068,7 @@ async function main() {
   const server = new McpServer({ name: "standup-mr", version: packageVersion(import.meta.url) });
   server.tool(
     "get_standup_data",
-    "Collect merge-request-based standup data from GitLab or GitHub. Returns the previous working day activity, open merge requests or pull requests bucketed by state (ready / blocked / draft / stale), pending reviews, and the error lines from any failed pipeline or check. Credentials come from the environment or a logged-in gh / glab session, never from an argument.",
+    STANDUP_TOOL_DESCRIPTION,
     STANDUP_TOOL_SCHEMA,
     async (args) => await runStandupTool(args)
   );
@@ -1088,6 +1089,7 @@ if (entryUrl && import.meta.url === entryUrl) {
   });
 }
 export {
+  STANDUP_TOOL_DESCRIPTION,
   STANDUP_TOOL_SCHEMA,
   collect,
   main,

package/llms-install.md

@@ -0,0 +1,79 @@
+# Installing standup-mr
+
+Instructions for an AI assistant setting this MCP server up on a user's
+machine. Everything here is verified against the published package.
+
+## What it needs
+
+- Node.js 20 or newer. Nothing to clone, nothing to build — the server runs
+  straight from npm.
+- Read access to the user's GitLab or GitHub. It never takes a credential as
+  a tool argument; credentials come from the environment or from a logged-in
+  `gh` / `glab` session.
+
+## Config
+
+Add this to the MCP settings file (for Cline,
+`cline_mcp_settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "standup": {
+      "command": "npx",
+      "args": ["-y", "standup-mr", "mcp"],
+      "env": {}
+    }
+  }
+}
+```
+
+That is the whole install when the user already has `gh` or `glab` logged in
+— leave `env` empty and the server picks the session up.
+
+## Credentials, when there is no CLI session
+
+Add only the pair the user actually needs.
+
+| Variable | When |
+|---|---|
+| `GITHUB_TOKEN` | GitHub, no `gh` session |
+| `GITHUB_HOST` | GitHub Enterprise only; defaults to `github.com` |
+| `GITLAB_TOKEN` | GitLab, no `glab` session |
+| `GITLAB_HOST` | **Required for GitLab** — there is no default host |
+| `STANDUP_PROVIDER` | `github` or `gitlab`, when both are configured and the choice is ambiguous |
+
+Ask the user for a token; do not invent one, and do not put a token anywhere
+but `env`.
+
+## The one tool
+
+`get_standup_data` returns the previous working day's activity, open merge
+requests bucketed by state (ready / blocked / draft / stale), pending
+reviews, and the error lines from any failed pipeline job. All three
+arguments are optional:
+
+- `provider` — `github` or `gitlab`; omit to auto-detect
+- `host` — self-hosted host, no scheme
+- `lang` — `en` or `tr`; changes date labels in the JSON only
+
+## Verifying the install
+
+```bash
+npx -y standup-mr mcp
+```
+
+It speaks MCP over stdio and writes nothing else to stdout. A successful
+`initialize` reports `{"name":"standup-mr","version":"<current>"}`.
+
+If the user is not on an MCP client, `npx standup-mr fetch --markdown`
+prints the same data as a digest.
+
+## Writing the note
+
+The tool returns data, not prose. The note-writing rules live in the bundled
+skill; pour them into whatever instructions file the assistant reads:
+
+```bash
+npx standup-mr instructions >> AGENTS.md
+```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "standup-mr",
-    "version": "0.4.0",
+    "version": "0.4.1",
     "mcpName": "io.github.Jubstaaa/standup-mr",
     "description": "Standup notes from merge request state, not commit logs.",
     "keywords": [
@@ -48,6 +48,7 @@
         "dist",
         "skills",
         "mcp/README.md",
+        "llms-install.md",
         "README.md",
         "CHANGELOG.md",
         "LICENSE"