mcp-server-mojaq 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MOJAQ
+
+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.

package/README.md

@@ -0,0 +1,51 @@
+# mcp-server-mojaq
+
+Read-only [MCP](https://modelcontextprotocol.io) server for [MOJAQ](https://mojaq.com) — ask Claude, Claude Code or Cursor about your EU-hosted app's **deploys, errors, logs, uptime, incidents and root-cause hints**, in natural language.
+
+Because MOJAQ keeps all of these in one place, your AI assistant can *correlate* across them — "errors spiked 4 minutes after deploy `v2.4.0` while flag `new-checkout` was on" — right inside your editor. It is **strictly read-only**: no tool can change or delete anything.
+
+## Setup
+
+You need a MOJAQ API key (from [mojaq.com/app/api-keys](https://mojaq.com/app/api-keys)).
+
+**Claude Desktop / Claude Code / Cursor** — add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "mojaq": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-mojaq"],
+      "env": { "MOJAQ_API_KEY": "mq_your_key_here" }
+    }
+  }
+}
+```
+
+Then ask your assistant things like:
+
+- *"What broke in the last hour?"*
+- *"Show me the errors on /checkout and tail the payment-service logs for timeouts."*
+- *"What did the last deploy change, and did error rates go up after it?"*
+- *"Is anything down right now?"*
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `project_summary` | Monitors + status, open incidents, recent deploys, root-cause hints, log volume |
+| `get_timeline` | One chronological feed of deploys, incidents, flag changes and hints |
+| `explain_recent_regression` | Timeline for the last N hours, to reason about a recent regression |
+| `query_logs` | Search logs by text, level, service and time window |
+| `get_deploys` | Recent deployments |
+| `uptime_status` | Uptime monitors and their status |
+| `search_errors` | Recent error-tracking events |
+
+## Config
+
+| Env | Required | Default |
+|-----|----------|---------|
+| `MOJAQ_API_KEY` | yes | — |
+| `MOJAQ_API_URL` | no | `https://api.mojaq.com` |
+
+Read-only. MIT licensed. EU-hosted (Helsinki).

package/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * MOJAQ MCP server (read-only).
+ *
+ * Exposes your MOJAQ-monitored app to an AI assistant (Claude Desktop, Claude
+ * Code, Cursor, ...) as a set of read-only tools. The AI can ask what broke,
+ * search errors and logs, look at deploys and uptime, and correlate across all
+ * of them — but it can never mutate anything.
+ *
+ * Config (env):
+ *   MOJAQ_API_KEY   (required)  your MOJAQ API key
+ *   MOJAQ_API_URL   (optional)  default https://api.mojaq.com
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const API_URL = (process.env.MOJAQ_API_URL || 'https://api.mojaq.com').replace(/\/+$/, '');
+const API_KEY = process.env.MOJAQ_API_KEY;
+
+if (!API_KEY) {
+  console.error('mcp-server-mojaq: MOJAQ_API_KEY is required. Get one at https://mojaq.com/app/api-keys');
+  process.exit(1);
+}
+
+async function apiGet(path, params = {}) {
+  const url = new URL(API_URL + path);
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, String(v));
+  }
+  const res = await fetch(url, {
+    headers: { 'x-api-key': API_KEY, 'user-agent': 'mcp-server-mojaq/1.0' },
+    signal: AbortSignal.timeout(20000),
+  });
+  const text = await res.text();
+  if (!res.ok) throw new Error(`MOJAQ API ${res.status}: ${text.slice(0, 300)}`);
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+const ok = (obj) => ({ content: [{ type: 'text', text: typeof obj === 'string' ? obj : JSON.stringify(obj, null, 2) }] });
+const fail = (e) => ({ content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true });
+const wrap = (fn) => async (args) => {
+  try {
+    return ok(await fn(args || {}));
+  } catch (e) {
+    return fail(e);
+  }
+};
+
+const server = new McpServer({ name: 'mojaq', version: '1.0.0' });
+
+server.tool(
+  'project_summary',
+  'High-level snapshot of the MOJAQ-monitored app: uptime monitors and their status, open incidents, recent deploys, recent root-cause hints, heartbeat count and 24h log volume. Start here.',
+  wrap(() => apiGet('/v1/summary')),
+);
+
+server.tool(
+  'get_timeline',
+  'Unified chronological feed of everything that happened across all tools: deploys, incidents, feature-flag changes and AI root-cause hints. Use this to answer "what changed / what happened recently".',
+  { since_hours: z.number().int().min(1).max(720).optional().describe('Look-back window in hours (default 168 = 7 days)'), limit: z.number().int().min(1).max(200).optional() },
+  wrap(({ since_hours, limit }) => apiGet('/v1/timeline', { since_hours, limit })),
+);
+
+server.tool(
+  'explain_recent_regression',
+  'Return the timeline for the last N hours (default 2) so you can reason about what likely caused a recent regression: which deploy, flag change or incident lines up with the problem.',
+  { since_hours: z.number().int().min(1).max(72).optional() },
+  wrap(({ since_hours }) => apiGet('/v1/timeline', { since_hours: since_hours ?? 2, limit: 100 })),
+);
+
+server.tool(
+  'query_logs',
+  'Search the app logs (EU-stored). Filter by free-text, level and service over a time window.',
+  {
+    q: z.string().optional().describe('Free-text to match in the log message'),
+    level: z.enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal']).optional(),
+    service: z.string().optional(),
+    since_minutes: z.number().int().min(1).max(10080).optional().describe('Look-back in minutes (default 60)'),
+    limit: z.number().int().min(1).max(500).optional(),
+  },
+  wrap(({ q, level, service, since_minutes, limit }) => apiGet('/v1/logs/query', { q, level, service, since_minutes, limit })),
+);
+
+server.tool(
+  'get_deploys',
+  'List recent deployments recorded in MOJAQ (version, environment, commit, time).',
+  wrap(() => apiGet('/v1/deploys')),
+);
+
+server.tool(
+  'uptime_status',
+  'List the uptime monitors and their current status.',
+  wrap(() => apiGet('/v1/monitors')),
+);
+
+server.tool(
+  'search_errors',
+  'List recent error-tracking events (Sentry-compatible) for the app.',
+  wrap(() => apiGet('/v1/errors/events')),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error('mcp-server-mojaq: ready (read-only) against ' + API_URL);

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "mcp-server-mojaq",
+  "version": "1.0.0",
+  "description": "Read-only MCP server for MOJAQ \u2014 ask Claude, Claude Code or Cursor about your EU-hosted app's deploys, errors, logs, uptime, analytics and incidents.",
+  "type": "module",
+  "bin": {
+    "mcp-server-mojaq": "index.js"
+  },
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "claude",
+    "cursor",
+    "mojaq",
+    "observability",
+    "monitoring",
+    "eu",
+    "gdpr"
+  ],
+  "homepage": "https://mojaq.com/mcp",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mojaqhq/mcp-server-mojaq.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mojaqhq/mcp-server-mojaq/issues"
+  },
+  "author": "MOJAQ"
+}