altalandi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Altalandi
+
+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,53 @@
+# altalandi-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that exposes
+[Altalandi](https://altalandi.is) — native-Icelandic refinement with a
+meaning-preservation check — as a tool any MCP client (Claude Code, etc.) can
+call. stdio transport.
+
+## Use it in Claude Code
+
+Add to your MCP config (`.mcp.json` in the project, or your Claude Code config):
+
+```json
+{
+  "mcpServers": {
+    "altalandi": {
+      "command": "npx",
+      "args": ["-y", "altalandi-mcp"],
+      "env": { "ALTALANDI_API_KEY": "rtv_..." }
+    }
+  }
+}
+```
+
+Mint a key at <https://altalandi.is/portal>. Then ask Claude to use the
+**`refine_icelandic`** tool.
+
+## The tool
+
+`refine_icelandic({ text, domain?, register?, sourceLang? })` → the native
+Icelandic text, a 0–100 nativeness score, and whether meaning was preserved.
+
+- `domain`: `general` \| `marketing` \| `data-analysis` \| `childrens-fiction`
+- `register`: `formal` \| `neutral` \| `warm`
+- `sourceLang`: `auto` \| `en` \| `is`
+
+**Meaning guarantee:** on Icelandic input where the rewrite can't be verified to
+preserve meaning, the tool returns the **original unchanged** and flags it —
+never a silent change.
+
+## Config
+
+| env | default | purpose |
+|-----|---------|---------|
+| `ALTALANDI_API_KEY` | — | your key (Bearer). Mint at https://altalandi.is/portal |
+| `ALTALANDI_BASE_URL` | `https://altalandi.is/api` | API base (override for self-hosting) |
+
+## Run standalone
+
+```bash
+ALTALANDI_API_KEY=rtv_... npx -y altalandi-mcp     # speaks MCP over stdio
+```
+
+MIT licensed. Requires Node ≥ 18. The hosted API is metered per key.

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "altalandi-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing Altalandi (native-Icelandic refinement) as a tool for Claude Code and any MCP client.",
+  "type": "module",
+  "bin": { "altalandi-mcp": "./server.mjs" },
+  "files": ["server.mjs", "README.md", "LICENSE"],
+  "keywords": [
+    "icelandic", "íslenska", "mcp", "model-context-protocol", "claude",
+    "claude-code", "altalandi", "nlp", "translation", "agent"
+  ],
+  "homepage": "https://altalandi.is",
+  "repository": { "type": "git", "url": "git+https://github.com/pbidhjorvar/ritvit.git", "directory": "tools/mcp" },
+  "bugs": { "url": "https://github.com/pbidhjorvar/ritvit/issues" },
+  "engines": { "node": ">=18" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "license": "MIT"
+}

package/server.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// Altalandi MCP server — exposes native-Icelandic refinement as a tool that
+// Claude Code (and any MCP client) can call. stdio transport.
+//
+//   ALTALANDI_API_KEY=... npx -y altalandi-mcp
+//
+// Claude Code config (.mcp.json or your Claude Code config) — no install:
+//   { "mcpServers": { "altalandi": {
+//       "command": "npx",
+//       "args": ["-y", "altalandi-mcp"],
+//       "env": { "ALTALANDI_API_KEY": "rtv_..." } } } }
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const BASE = (process.env.ALTALANDI_BASE_URL || "https://altalandi.is/api").replace(/\/$/, "");
+const KEY = process.env.ALTALANDI_API_KEY || process.env.ALTALANDI_KEY;
+
+const server = new McpServer({ name: "altalandi", version: "0.1.0" });
+
+server.tool(
+  "refine_icelandic",
+  "Rewrite English or stiff/AI-translated Icelandic into native-sounding Icelandic, with a meaning-preservation check. Use whenever you need Icelandic that must read like a native wrote it (marketing copy, UI strings, prose). Returns the refined text, a 0-100 nativeness score, and whether meaning was preserved (on drift it returns the original unchanged).",
+  {
+    text: z.string().describe("Text to refine (English or Icelandic)."),
+    domain: z.enum(["general", "marketing", "data-analysis", "childrens-fiction"]).optional()
+      .describe("Tunes register/idiom. Default general."),
+    register: z.enum(["formal", "neutral", "warm"]).optional().describe("Tone. Default neutral."),
+  },
+  async ({ text, domain, register }) => {
+    if (!KEY) {
+      return { content: [{ type: "text", text: "ALTALANDI_API_KEY is not set for the MCP server." }], isError: true };
+    }
+    try {
+      const res = await fetch(`${BASE}/v1/refine`, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${KEY}` },
+        body: JSON.stringify({ text, domain, register }),
+      });
+      const data = await res.json().catch(() => ({}));
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Altalandi error ${res.status}: ${data.detail || res.statusText}` }], isError: true };
+      }
+      const q = data.quality || {};
+      const drift = data.meaningPreserved === false ? " (MEANING DRIFT — original returned unchanged)" : "";
+      return {
+        content: [{ type: "text", text: `${data.output}\n\n— nativeness ${q.nativenessScore ?? "n/a"}/100${drift}` }],
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Request failed: ${e.message}` }], isError: true };
+    }
+  },
+);
+
+await server.connect(new StdioServerTransport());