standup-mr 0.3.3 → 0.4.1

package/CHANGELOG.md

@@ -4,6 +4,42 @@ 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
+
+- **The MCP tool takes arguments.** `get_standup_data` exposed an empty input
+  schema, so an MCP client could not pick a provider, point at a self-hosted
+  host, or ask for Turkish date labels — all of which the CLI has always
+  allowed. `provider` (`github` / `gitlab`), `host` and `lang` (`en` / `tr`)
+  are now declared options, each with a description. The two enums replace
+  free strings, so an unsupported language is rejected instead of silently
+  falling back to English.
+
+  No token argument, deliberately: credentials come from the environment or a
+  logged-in `gh` / `glab` session, and a tool argument would end up in the
+  transcript.
+
+### Changed
+
+- `zod` is a direct dependency rather than one borrowed from the MCP SDK's
+  dependency tree.
+
 ## [0.3.3] - 2026-09-01
 
 ### Fixed

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

@@ -5,6 +5,7 @@ import { realpathSync } from "fs";
 import { pathToFileURL } from "url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
 
 // src/manifest/manifest.ts
 import { existsSync, readFileSync } from "fs";
@@ -1043,16 +1044,33 @@ 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. 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. 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: 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) {
+  const report = await collector({
+    provider: args.provider,
+    host: args.host,
+    lang: args.lang
+  });
+  return { content: [{ type: "text", text: JSON.stringify(report) }] };
+}
 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.",
-    {},
-    async () => {
-      const report = await collect();
-      return { content: [{ type: "text", text: JSON.stringify(report) }] };
-    }
+    STANDUP_TOOL_DESCRIPTION,
+    STANDUP_TOOL_SCHEMA,
+    async (args) => await runStandupTool(args)
   );
   await server.connect(new StdioServerTransport());
 }
@@ -1071,6 +1089,9 @@ if (entryUrl && import.meta.url === entryUrl) {
   });
 }
 export {
+  STANDUP_TOOL_DESCRIPTION,
+  STANDUP_TOOL_SCHEMA,
   collect,
-  main
+  main,
+  runStandupTool
 };

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.3.3",
+    "version": "0.4.1",
     "mcpName": "io.github.Jubstaaa/standup-mr",
     "description": "Standup notes from merge request state, not commit logs.",
     "keywords": [
@@ -14,7 +14,7 @@
     ],
     "license": "MIT",
     "author": {
-        "name": "\u0130lker Balc\u0131lar",
+        "name": "İlker Balcılar",
         "email": "ilkerbalcilartr@gmail.com"
     },
     "repository": {
@@ -48,6 +48,7 @@
         "dist",
         "skills",
         "mcp/README.md",
+        "llms-install.md",
         "README.md",
         "CHANGELOG.md",
         "LICENSE"
@@ -60,7 +61,8 @@
         "prepublishOnly": "tsup"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk": "^1.0.0"
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "zod": "^4.4.3"
     },
     "devDependencies": {
         "@types/bun": "^1.0.0",