@agentrysh/mcp 0.0.1

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// Agentry stdio MCP server. Runs in the user's Claude Code via stdio.
+// Talks to the agentry API over HTTPS using the user's API key.
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TOOL_DESCRIPTORS, dispatchTool } from "./tools.js";
+async function main() {
+    const server = new Server({ name: "agentry", version: "0.0.1" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DESCRIPTORS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const name = req.params.name;
+        const args = (req.params.arguments ?? {});
+        const result = await dispatchTool(name, args);
+        // MCP content blocks: return a single JSON text block. Agents parse it.
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+            // If the result has a top-level `error`, signal that to the client too.
+            isError: Boolean(result.error),
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Keep the process alive — connect() returns once the transport is ready,
+    // not when it closes. The transport handles its own lifecycle on stdin EOF.
+}
+main().catch((err) => {
+    // stderr is the only safe channel — stdout is the MCP protocol.
+    // eslint-disable-next-line no-console
+    console.error("[agentry-mcp] fatal:", err instanceof Error ? err.stack ?? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,sEAAsE;AACtE,gEAAgE;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EACrC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,wEAAwE;QACxE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;YACD,wEAAwE;YACxE,OAAO,EAAE,OAAO,CAAE,MAA8B,CAAC,KAAK,CAAC;SACxD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,0EAA0E;IAC1E,4EAA4E;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,gEAAgE;IAChE,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,24 @@
+export declare const MEMORY_FILENAME = "agentry_memory.md";
+export interface RememberInput {
+    case_id: string;
+    /** Short markdown body — what was learned. */
+    summary: string;
+    /** Optional structured fields surfaced as bullets. */
+    fingerprint?: string;
+    status?: string;
+    error_type?: string;
+    pr_url?: string;
+    watch_for?: string;
+    tags?: string[];
+}
+export interface RememberResult {
+    ok: boolean;
+    file_path: string;
+    action: "created" | "appended" | "updated";
+    next_action: string;
+}
+export declare function getMemoryPath(localPath: string | null | undefined): string | null;
+export declare function ensureMemoryFile(filePath: string): "created" | "exists";
+export declare function upsertCaseSection(filePath: string, input: RememberInput): "created" | "appended" | "updated";
+export declare function readCaseSection(filePath: string, caseId: string): string | null;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAYnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGjF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAMvE;AAwBD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,SAAS,GAAG,UAAU,GAAG,SAAS,CA4BpC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS/E"}

package/dist/memory.js

@@ -0,0 +1,99 @@
+// Local agent memory: a markdown file in the customer's repo at
+// `<local_path>/agentry_memory.md`. Each case gets a section the agent can
+// upsert; the file is grep-able, git-versionable, and human-editable.
+//
+// Why a local file instead of a server table:
+//   - Survives even if agentry's server data is lost
+//   - Grep-able with the agent's existing Read/Grep/Glob tools — no extra MCP needed for read
+//   - Git-versioned with the customer's code (commit or .gitignore is their call)
+//   - The customer can edit it directly; the agent will see those edits
+//   - No server-side schema for what is fundamentally tacit knowledge
+import * as fs from "node:fs";
+import * as path from "node:path";
+export const MEMORY_FILENAME = "agentry_memory.md";
+const HEADER = `# Agentry memory
+
+Notes the agent has accumulated investigating cases. Safe to commit (no secrets here).
+
+Each \`## Case <id>\` section is upserted by \`agentry_remember\`. The agent reads
+this file directly with its built-in file tools when investigating a similar case.
+
+---
+`;
+export function getMemoryPath(localPath) {
+    if (!localPath)
+        return null;
+    return path.join(localPath, MEMORY_FILENAME);
+}
+export function ensureMemoryFile(filePath) {
+    if (fs.existsSync(filePath))
+        return "exists";
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, HEADER, "utf8");
+    return "created";
+}
+function buildSection(input) {
+    const ts = new Date().toISOString();
+    const lines = [];
+    lines.push(`## Case ${input.case_id}`);
+    if (input.error_type)
+        lines.push(`- **Error type**: ${input.error_type}`);
+    if (input.fingerprint)
+        lines.push(`- **Fingerprint**: \`${input.fingerprint}\``);
+    if (input.status)
+        lines.push(`- **Status**: ${input.status}`);
+    lines.push(`- **Last touched**: ${ts}`);
+    if (input.pr_url)
+        lines.push(`- **PR**: ${input.pr_url}`);
+    if (input.tags && input.tags.length > 0) {
+        lines.push(`- **Tags**: ${input.tags.map((t) => "`" + t + "`").join(", ")}`);
+    }
+    lines.push("");
+    lines.push(input.summary.trim());
+    if (input.watch_for) {
+        lines.push("");
+        lines.push(`**Watch for:** ${input.watch_for.trim()}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export function upsertCaseSection(filePath, input) {
+    const initState = ensureMemoryFile(filePath);
+    const existing = fs.readFileSync(filePath, "utf8");
+    const sectionHeader = `## Case ${input.case_id}`;
+    // Find existing section start.
+    const headerIdx = existing.indexOf(sectionHeader);
+    if (headerIdx === -1) {
+        // Append a new section.
+        const newSection = buildSection(input);
+        const sep = existing.endsWith("\n") ? "" : "\n";
+        fs.writeFileSync(filePath, `${existing}${sep}\n${newSection}\n`, "utf8");
+        return initState === "created" ? "created" : "appended";
+    }
+    // Find next section header (## Case ...) or end of file.
+    const after = existing.slice(headerIdx + sectionHeader.length);
+    const nextSectionRel = after.search(/\n## Case /);
+    const sectionEnd = nextSectionRel === -1
+        ? existing.length
+        : headerIdx + sectionHeader.length + nextSectionRel + 1; // +1 to keep the blank line before next section
+    const before = existing.slice(0, headerIdx);
+    const afterSection = existing.slice(sectionEnd);
+    const replaced = `${before}${buildSection(input)}\n${afterSection.trimStart()}`;
+    fs.writeFileSync(filePath, replaced, "utf8");
+    return "updated";
+}
+export function readCaseSection(filePath, caseId) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const text = fs.readFileSync(filePath, "utf8");
+    const header = `## Case ${caseId}`;
+    const idx = text.indexOf(header);
+    if (idx === -1)
+        return null;
+    const after = text.slice(idx);
+    const nextRel = after.slice(header.length).search(/\n## Case /);
+    return nextRel === -1 ? after : after.slice(0, header.length + nextRel + 1);
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"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"}

package/dist/onboarding.d.ts

@@ -0,0 +1,10 @@
+import type { AgentryConfig } from "@agentrysh/shared";
+export type OnboardingState = "no_key" | "no_project" | "needs_install" | "ready";
+export interface OnboardingHint {
+    state: OnboardingState;
+    next_tool: string | null;
+    next_action: string;
+    message: string;
+}
+export declare function getOnboardingHint(cfg: AgentryConfig): OnboardingHint;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../src/onboarding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAgDpE"}

package/dist/onboarding.js

@@ -0,0 +1,46 @@
+// Compute structured onboarding hints for the agent.
+// agentry_status pipes this through; tools also return individual hints.
+export function getOnboardingHint(cfg) {
+    if (!cfg.api_key) {
+        return {
+            state: "no_key",
+            next_tool: "agentry_login",
+            next_action: "Call `agentry_login`. It returns a verification URL and a short user_code; " +
+                "ask the user to open the URL in their browser and paste the code. " +
+                "The tool blocks until GitHub authorizes (~30s), then persists the api_key locally.",
+            message: "No API key on file. Call `agentry_login` to authenticate via GitHub (no email or password required).",
+        };
+    }
+    const projectIds = Object.keys(cfg.projects);
+    if (projectIds.length === 0 || !cfg.default_project_id) {
+        return {
+            state: "no_project",
+            next_tool: "agentry_create_project",
+            next_action: "Ask the user for a project name (and optionally repo_url + local_path of the repo), " +
+                "then call `agentry_create_project`. The response includes the DSN and SDK install snippet.",
+            message: "API key on file, but no project yet. Call `agentry_create_project` to mint a DSN.",
+        };
+    }
+    // After project creation, the SDK isn't installed yet in the customer's app.
+    // We don't know for sure — but we lean on a local marker. If install_verified
+    // hasn't been set on any project, treat as needs_install.
+    const anyVerified = projectIds.some((id) => cfg.projects[id]?.install_verified === true);
+    if (!anyVerified) {
+        return {
+            state: "needs_install",
+            next_tool: "agentry_install_guide",
+            next_action: "Project created, but the SDK isn't proven installed yet. " +
+                "Call `agentry_install_guide` for the comprehensive checklist, walk through it, then call " +
+                "`agentry_verify_install` — that's how we know errors, analytics, and deploys are actually flowing.",
+            message: "Project ready, but install hasn't been verified. Run agentry_install_guide → agentry_verify_install.",
+        };
+    }
+    return {
+        state: "ready",
+        next_tool: "agentry_list_cases",
+        next_action: "Onboarding done. Call `agentry_list_cases` to see open errors, or " +
+            "`agentry_analytics_query` to investigate funnels.",
+        message: "Set up — install verified, signals flowing. Ready to investigate.",
+    };
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../src/onboarding.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,yEAAyE;AAazE,MAAM,UAAU,iBAAiB,CAAC,GAAkB;IAClD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,eAAe;YAC1B,WAAW,EACT,6EAA6E;gBAC7E,oEAAoE;gBACpE,oFAAoF;YACtF,OAAO,EACL,sGAAsG;SACzG,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvD,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,wBAAwB;YACnC,WAAW,EACT,sFAAsF;gBACtF,4FAA4F;YAC9F,OAAO,EACL,mFAAmF;SACtF,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,8EAA8E;IAC9E,0DAA0D;IAC1D,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC;IACzF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,uBAAuB;YAClC,WAAW,EACT,2DAA2D;gBAC3D,2FAA2F;gBAC3F,oGAAoG;YACtG,OAAO,EAAE,sGAAsG;SAChH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EACT,oEAAoE;YACpE,mDAAmD;QACrD,OAAO,EAAE,mEAAmE;KAC7E,CAAC;AACJ,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,16 @@
+export interface ToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+}
+export declare const TOOL_DESCRIPTORS: ToolDescriptor[];
+export interface ToolResult {
+    [k: string]: unknown;
+}
+export declare function dispatchTool(name: string, args: Record<string, unknown> | undefined): Promise<ToolResult>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAyjB5C,CAAC;AAmHF,MAAM,WAAW,UAAU;IAEzB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC,UAAU,CAAC,CA4LrB"}