@transita/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Transita / Okapi Works
+
+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,158 @@
+# @transita/mcp-server
+
+> Immigration eligibility intelligence for Claude Desktop, Cursor, Cline, Continue, Zed, and any MCP-compatible AI assistant.
+
+[Transita](https://transita.app) figures out which country you should move to — and runs the whole relocation. This MCP server exposes the same matcher, country comparisons, visa checklists, and nationality guides that power transita.app, so you can ask any AI assistant "where should I move?" and get a real, sourced answer.
+
+The server is a stateless shim. It calls the public Transita JSON API, so visa data updates the moment transita.app redeploys. No data lives in this package.
+
+## Install
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "transita": {
+      "command": "npx",
+      "args": ["-y", "@transita/mcp-server"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The Transita tools should appear in the input box.
+
+### Cursor
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "transita": {
+      "command": "npx",
+      "args": ["-y", "@transita/mcp-server"]
+    }
+  }
+}
+```
+
+### Cline (VS Code extension)
+
+Open the Cline MCP settings panel and add:
+
+```json
+{
+  "transita": {
+    "command": "npx",
+    "args": ["-y", "@transita/mcp-server"]
+  }
+}
+```
+
+### Continue, Zed, any other MCP client
+
+Use the same pattern — `command: npx`, `args: ["-y", "@transita/mcp-server"]`.
+
+## What it exposes
+
+### Tools (5)
+
+| Tool | What it does |
+|---|---|
+| `transita_match_visas` | Score a profile (citizenship, education, work years, income, goal, timeline) against every visa Transita supports. Returns top matches ranked by eligibility. |
+| `transita_visa_details` | Full details for a single visa: eligibility, processing time, fees, validity, PR path, and a free preview of the document checklist. |
+| `transita_compare_visas` | Side-by-side comparison of 2-3 visa pathways with deltas (fastest processing, lowest cost, longest validity, PR path). |
+| `transita_country_overview` | Country-level summary: number of visa pathways, EU membership, score dimensions, drawbacks, top cities with rent ranges, PR/citizenship timelines. |
+| `transita_search_by_nationality` | Curated top destinations and recommended visas for citizens of a given country. Best first stop for "where should I move?" |
+
+### Resources (4 base + dynamic templates)
+
+- `transita://visas` — full active visa catalogue
+- `transita://countries` — destination countries + visa counts
+- `transita://nationalities` — index of curated nationality landing pages
+- `transita://nationality/<slug>` — single nationality page (e.g. `transita://nationality/indian`)
+
+### Prompts (3)
+
+- `find-my-visa` — guided eligibility quiz then `transita_match_visas`
+- `compare-options` — drives `transita_compare_visas` with a chosen set of ids
+- `where-should-i-move` — open exploration starting from nationality
+
+## Try it
+
+Once installed, ask your AI assistant questions like:
+
+- *"I'm an Indian software engineer with a master's and 5 years of experience. Where should I move?"*
+- *"Compare the US O-1A, Germany's EU Blue Card, and Portugal's D8 — which is fastest, cheapest, and which has the best path to permanent residency?"*
+- *"What does Portugal's D8 digital nomad visa actually require?"*
+- *"How do destination scores compare for Germany versus the Netherlands?"*
+
+The model will pick the right Transita tool, call it, and synthesise the answer. Visa data is verified by the Transita team monthly; every match links back to the official government source.
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `TRANSITA_API_URL` | `https://transita.app` | Override the API base URL (useful for local dev against `http://localhost:3000`). |
+| `TRANSITA_MCP_USER_AGENT` | `transita-mcp-server/0.1.0` | Custom UA string for analytics. |
+
+## Free vs paid
+
+Everything this MCP server exposes is **free**. The full document checklist + 30-day action plan is part of Transita's $9 paid plan and lives at `https://transita.app/visa/<id>`. The MCP server's tools include a checklist preview (lead time, ancillary cost, first section) and link to the full plan.
+
+## Development
+
+```bash
+git clone https://github.com/snenenenenenene/mova.git
+cd mova/packages/mcp-server
+bun install
+bun run build
+
+# Point at a local Transita dev server
+TRANSITA_API_URL=http://localhost:3000 node dist/cli.js
+```
+
+To smoke-test from the command line:
+
+```bash
+{
+  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0"}}}'
+  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
+  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
+} | node dist/cli.js
+```
+
+## Publishing to npm + the MCP Registry
+
+Two-step flow. The MCP Registry stores metadata; npm hosts the artifact.
+
+```bash
+# 1. Publish to npm (must be on a fresh version; bump in package.json first)
+cd packages/mcp-server
+bun run build
+npm publish --access public
+
+# 2. Publish metadata to the MCP Registry
+#    Install mcp-publisher once: brew install mcp-publisher
+#    server.json is committed alongside this README.
+mcp-publisher login github
+mcp-publisher publish
+```
+
+After publishing, the server is listed at <https://registry.modelcontextprotocol.io>
+and discoverable inside MCP-compatible clients.
+
+## License
+
+MIT — see LICENSE.
+
+## Links
+
+- Website: <https://transita.app>
+- MCP landing page: <https://transita.app/mcp>
+- Source: <https://github.com/snenenenenenene/mova/tree/main/packages/mcp-server>
+- MCP protocol: <https://modelcontextprotocol.io>

package/dist/api.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Thin HTTP client over the public Transita JSON API.
+ *
+ * The MCP server is a stateless shim — it never owns visa data. It
+ * forwards every tool call to transita.app, which means visa updates
+ * propagate the moment the website redeploys. The API base URL can
+ * be overridden via the TRANSITA_API_URL env var to point at a local
+ * dev server during testing.
+ */
+export declare const API_BASE_URL: string;
+interface FetchJsonOptions {
+    method?: "GET" | "POST";
+    body?: unknown;
+    signal?: AbortSignal;
+}
+export declare function fetchJson<T>(path: string, opts?: FetchJsonOptions): Promise<T>;
+export {};

package/dist/api.js

@@ -0,0 +1,48 @@
+/**
+ * Thin HTTP client over the public Transita JSON API.
+ *
+ * The MCP server is a stateless shim — it never owns visa data. It
+ * forwards every tool call to transita.app, which means visa updates
+ * propagate the moment the website redeploys. The API base URL can
+ * be overridden via the TRANSITA_API_URL env var to point at a local
+ * dev server during testing.
+ */
+export const API_BASE_URL = process.env.TRANSITA_API_URL?.replace(/\/$/, "") ?? "https://transita.app";
+const USER_AGENT = process.env.TRANSITA_MCP_USER_AGENT ?? "transita-mcp-server/0.1.0";
+export async function fetchJson(path, opts = {}) {
+    const url = `${API_BASE_URL}${path}`;
+    const init = {
+        method: opts.method ?? "GET",
+        headers: {
+            "Accept": "application/json",
+            "User-Agent": USER_AGENT,
+            "X-Source": "MCP",
+            ...(opts.body !== undefined ? { "Content-Type": "application/json" } : {}),
+        },
+        signal: opts.signal,
+    };
+    if (opts.body !== undefined) {
+        init.body = JSON.stringify(opts.body);
+    }
+    const res = await fetch(url, init);
+    const text = await res.text();
+    if (!res.ok) {
+        let detail = text;
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed?.error)
+                detail = parsed.error;
+        }
+        catch {
+            // leave detail as raw text
+        }
+        throw new Error(`Transita API ${res.status} ${res.statusText} on ${path}: ${detail}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Transita API returned non-JSON body on ${path}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,YAAY,GACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC;AAE7E,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,2BAA2B,CAAC;AAQrE,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,OAAyB,EAAE;IAE3B,MAAM,GAAG,GAAG,GAAG,YAAY,GAAG,IAAI,EAAE,CAAC;IACrC,MAAM,IAAI,GAAgB;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,OAAO,EAAE;YACP,QAAQ,EAAE,kBAAkB;YAC5B,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,KAAK;YACjB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E;QACD,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;YACtD,IAAI,MAAM,EAAE,KAAK;gBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gBAAgB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,OAAO,IAAI,KAAK,MAAM,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Transita MCP server — stdio entry point.
+ *
+ * Used by Claude Desktop, Cursor, Cline, Continue, Zed, and any
+ * MCP-compatible client that spawns servers as subprocesses. Reads
+ * MCP messages from stdin and writes responses to stdout — all
+ * logging goes to stderr to stay out of the protocol stream.
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Transita MCP server — stdio entry point.
+ *
+ * Used by Claude Desktop, Cursor, Cline, Continue, Zed, and any
+ * MCP-compatible client that spawns servers as subprocesses. Reads
+ * MCP messages from stdin and writes responses to stdout — all
+ * logging goes to stderr to stay out of the protocol stream.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createTransitaMcpServer, SERVER_NAME, SERVER_VERSION } from "./server.js";
+import { API_BASE_URL } from "./api.js";
+async function main() {
+    const server = createTransitaMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[${SERVER_NAME}@${SERVER_VERSION}] connected over stdio (api=${API_BASE_URL})\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[transita-mcp] fatal: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,WAAW,IAAI,cAAc,+BAA+B,YAAY,KAAK,CAClF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAA0B,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts/index.js

@@ -0,0 +1,73 @@
+import { z } from "zod/v3";
+export function registerPrompts(server) {
+    server.registerPrompt("find-my-visa", {
+        title: "Find my visa",
+        description: "Walk a user through Transita's eligibility quiz, then call transita_match_visas with their answers.",
+        argsSchema: {
+            citizenship: z
+                .string()
+                .optional()
+                .describe("Pre-fill the user's nationality if known."),
+        },
+    }, ({ citizenship }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I want to find a visa pathway using Transita. ` +
+                        (citizenship
+                            ? `My nationality is ${citizenship}. `
+                            : `Please ask me for my nationality first. `) +
+                        `After collecting my nationality, ask me — one at a time — for my education level, total years of work experience, primary work field, annual income (USD), relocation goal, target countries (or leave open), and timeline. Then call the transita_match_visas tool with my answers and summarise the top 3 matches with concrete next steps.`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("compare-options", {
+        title: "Compare visa options",
+        description: "Compare two or three Transita visa ids side-by-side with deltas and recommendations.",
+        argsSchema: {
+            visa_ids: z
+                .string()
+                .describe("Comma-separated Transita visa ids (e.g. 'us-o1a,de-blue-card,pt-d7')."),
+        },
+    }, ({ visa_ids }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Compare these visas using transita_compare_visas: ${visa_ids}. ` +
+                        `After receiving the data, summarise which option fits which kind of applicant best, ` +
+                        `and call transita_visa_details on each id to surface the document-checklist preview if useful.`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("where-should-i-move", {
+        title: "Where should I move?",
+        description: "Open-ended exploration. Surfaces nationality-specific top destinations, then drills into matches.",
+        argsSchema: {
+            nationality: z.string().describe("User's nationality, e.g. 'Indian'."),
+            profession: z
+                .string()
+                .optional()
+                .describe("Optional — narrows the recommended visas."),
+        },
+    }, ({ nationality, profession }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I'm a ${profession ? `${profession} ` : ""}${nationality} citizen looking to move abroad. ` +
+                        `First, call transita_search_by_nationality with my nationality to surface the curated top destinations. ` +
+                        `Then, ask me a few quick clarifying questions (income range, timeline, family or solo) and call transita_match_visas with my answers. ` +
+                        `End with a concrete recommendation: which 2-3 pathways are worth investigating and what to do this week.`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,qGAAqG;QACvG,UAAU,EAAE;YACV,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;SACzD;KACF,EACD,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACpB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,gDAAgD;wBAChD,CAAC,WAAW;4BACV,CAAC,CAAC,qBAAqB,WAAW,IAAI;4BACtC,CAAC,CAAC,0CAA0C,CAAC;wBAC/C,+UAA+U;iBAClV;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,sFAAsF;QACxF,UAAU,EAAE;YACV,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CACP,uEAAuE,CACxE;SACJ;KACF,EACD,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACjB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,qDAAqD,QAAQ,IAAI;wBACjE,sFAAsF;wBACtF,gGAAgG;iBACnG;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,qBAAqB,EACrB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,mGAAmG;QACrG,UAAU,EAAE;YACV,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACtE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;SACzD;KACF,EACD,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAChC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,SAAS,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,mCAAmC;wBAC5F,0GAA0G;wBAC1G,wIAAwI;wBACxI,0GAA0G;iBAC7G;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;

package/dist/resources/index.js

@@ -0,0 +1,82 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { fetchJson } from "../api.js";
+export function registerResources(server) {
+    server.registerResource("transita-visas", "transita://visas", {
+        title: "Transita visa catalogue",
+        description: "Full active list of every visa pathway Transita scores. Refreshed monthly.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await fetchJson("/api/visas");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("transita-countries", "transita://countries", {
+        title: "Transita destination countries",
+        description: "Active destination countries plus per-country visa counts.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await fetchJson("/api/countries");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("transita-nationalities", "transita://nationalities", {
+        title: "Transita nationality guides",
+        description: "Index of nationality-specific landing pages with curated top-destination guidance.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await fetchJson("/api/nationalities");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("transita-nationality", new ResourceTemplate("transita://nationality/{slug}", {
+        list: async () => {
+            const data = await fetchJson("/api/nationalities");
+            return {
+                resources: data.nationalities.map((n) => ({
+                    uri: `transita://nationality/${n.slug}`,
+                    name: `${n.flag} ${n.nationality}`,
+                    description: `Top destinations and recommended visas for ${n.nationality} citizens.`,
+                    mimeType: "application/json",
+                })),
+            };
+        },
+    }), {
+        title: "Transita nationality guide",
+        description: "Single nationality landing-page payload — top destinations, recommended visas, key stats, FAQ.",
+        mimeType: "application/json",
+    }, async (uri, { slug }) => {
+        const slugStr = Array.isArray(slug) ? slug[0] : String(slug);
+        const data = await fetchJson(`/api/nationality/${encodeURIComponent(slugStr)}`);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transita MCP server factory.
+ *
+ * Builds an McpServer with all Transita tools, resources, and prompts
+ * wired to the public Transita JSON API. The same factory is used by
+ * both the stdio CLI entry point (cli.ts) and the hosted SSE endpoint
+ * exposed at transita.app/api/mcp/sse.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_NAME = "transita";
+export declare const SERVER_VERSION = "0.1.0";
+export declare function createTransitaMcpServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,33 @@
+/**
+ * Transita MCP server factory.
+ *
+ * Builds an McpServer with all Transita tools, resources, and prompts
+ * wired to the public Transita JSON API. The same factory is used by
+ * both the stdio CLI entry point (cli.ts) and the hosted SSE endpoint
+ * exposed at transita.app/api/mcp/sse.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerMatchVisas } from "./tools/match-visas.js";
+import { registerVisaDetails } from "./tools/visa-details.js";
+import { registerCompareVisas } from "./tools/compare-visas.js";
+import { registerCountryOverview } from "./tools/country-overview.js";
+import { registerSearchByNationality } from "./tools/search-by-nationality.js";
+import { registerResources } from "./resources/index.js";
+import { registerPrompts } from "./prompts/index.js";
+export const SERVER_NAME = "transita";
+export const SERVER_VERSION = "0.1.0";
+export function createTransitaMcpServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        capabilities: { tools: {}, resources: {}, prompts: {}, logging: {} },
+        instructions: "Transita scores immigration eligibility across 8 countries and 45+ visa pathways. Start by calling transita_match_visas with the user's profile, or transita_search_by_nationality if they only know their citizenship. Use transita_visa_details and transita_compare_visas to drill in. The full document checklist + 30-day plan is paid ($9) and lives at https://transita.app/visa/<id>.",
+    });
+    registerMatchVisas(server);
+    registerVisaDetails(server);
+    registerCompareVisas(server);
+    registerCountryOverview(server);
+    registerSearchByNationality(server);
+    registerResources(server);
+    registerPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,UAAU,uBAAuB;IACrC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpE,YAAY,EACV,+XAA+X;KAClY,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/compare-visas.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCompareVisas(server: McpServer): void;

package/dist/tools/compare-visas.js

@@ -0,0 +1,44 @@
+import { z } from "zod/v3";
+import { fetchJson } from "../api.js";
+export function registerCompareVisas(server) {
+    server.registerTool("transita_compare_visas", {
+        title: "Compare visas",
+        description: "Compare 2-3 visa pathways side-by-side. Returns processing time, cost, validity, PR-pathway, and a delta summary highlighting the fastest, cheapest, and most permanent option.",
+        inputSchema: {
+            visa_ids: z
+                .array(z.string())
+                .min(2)
+                .max(3)
+                .describe("2-3 Transita visa ids. Discover ids via transita_match_visas or the transita://visas resource."),
+        },
+    }, async ({ visa_ids }) => {
+        const ids = visa_ids.map((s) => s.trim()).filter(Boolean);
+        const data = await fetchJson(`/api/compare?ids=${ids.map(encodeURIComponent).join(",")}`);
+        const idToVisa = new Map(data.visas.map((v) => [v.id, v]));
+        const named = (id) => {
+            const v = idToVisa.get(id);
+            return v ? `${v.countryFlag} ${v.countryName} ${v.code}` : id;
+        };
+        const lines = [
+            `Comparing ${data.visas.length} visa pathways:`,
+            ...data.visas.map((v) => `\n${v.countryFlag} ${v.countryName} — ${v.name} (${v.code})\n` +
+                `  Processing: ${v.processingTimeMonths.min}-${v.processingTimeMonths.max} months\n` +
+                `  Cost: $${v.costUSD} USD\n` +
+                `  Validity: ${v.validityYears} year(s)\n` +
+                `  Path to PR: ${v.pathToPR ? `yes${v.prTimelineYears != null ? ` (~${v.prTimelineYears}y)` : ""}` : "no"}`),
+            "",
+            "Deltas:",
+            `  Fastest processing: ${named(data.deltas.fastestProcessing)}`,
+            `  Lowest cost: ${named(data.deltas.lowestCost)}`,
+            `  Longest validity: ${named(data.deltas.longestValidity)}`,
+            data.deltas.pathToPR.length
+                ? `  Path to PR: ${data.deltas.pathToPR.map(named).join(", ")}`
+                : `  Path to PR: none of the compared options`,
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            structuredContent: data,
+        };
+    });
+}
+//# sourceMappingURL=compare-visas.js.map

package/dist/tools/compare-visas.js.map

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

package/dist/tools/country-overview.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCountryOverview(server: McpServer): void;

package/dist/tools/country-overview.js

@@ -0,0 +1,40 @@
+import { z } from "zod/v3";
+import { fetchJson } from "../api.js";
+export function registerCountryOverview(server) {
+    server.registerTool("transita_country_overview", {
+        title: "Country overview",
+        description: "Get summary data for a destination country: number of visa pathways, EU member status, score dimensions, drawbacks, top cities with rent ranges, and PR/citizenship timelines.",
+        inputSchema: {
+            country_code: z
+                .string()
+                .describe("Lowercase country code, e.g. 'us', 'de', 'pt'. List available codes via the transita://countries resource."),
+        },
+    }, async ({ country_code }) => {
+        const data = await fetchJson(`/api/country/${encodeURIComponent(country_code.toLowerCase())}`);
+        const c = data.country;
+        const lines = [
+            `${c.flag} ${c.name} (${c.code})${c.isEUMember ? " — EU member" : ""}`,
+            c.guideIntro,
+            "",
+            `Visa pathways supported: ${data.visaCount}`,
+            `PR after: ~${c.prTimelineYears} years · Citizenship after: ~${c.citizenshipTimelineYears} years`,
+            "",
+            "Score dimensions:",
+            ...c.scoreDimensions.map((s) => `  ${s.label}: ${s.score}/100`),
+            "",
+            "Cost of living (sample cities):",
+            ...c.cities.map((city) => `  ${city.city}: ${city.monthlyUSD}${city.note ? ` (${city.note})` : ""}`),
+            "",
+            "Drawbacks:",
+            ...c.drawbacks.map((d) => `  • ${d}`),
+            "",
+            "Visas available:",
+            ...data.visas.map((v) => `  - ${v.code}: ${v.name} (id: ${v.id})`),
+        ];
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            structuredContent: data,
+        };
+    });
+}
+//# sourceMappingURL=country-overview.js.map

package/dist/tools/country-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"country-overview.js","sourceRoot":"","sources":["../../src/tools/country-overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAStC,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,gLAAgL;QAClL,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CACP,4GAA4G,CAC7G;SACJ;KACF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,SAAS,CAC1B,gBAAgB,kBAAkB,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,EAAE,CACjE,CAAC;QAEF,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,MAAM,KAAK,GAAG;YACZ,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE;YACtE,CAAC,CAAC,UAAU;YACZ,EAAE;YACF,4BAA4B,IAAI,CAAC,SAAS,EAAE;YAC5C,cAAc,CAAC,CAAC,eAAe,gCAAgC,CAAC,CAAC,wBAAwB,QAAQ;YACjG,EAAE;YACF,mBAAmB;YACnB,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC;YAC/D,EAAE;YACF,iCAAiC;YACjC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACpG,EAAE;YACF,YAAY;YACZ,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,EAAE;YACF,kBAAkB;YAClB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;SACnE,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,iBAAiB,EAAE,IAA0C;SAC9D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/match-visas.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMatchVisas(server: McpServer): void;

package/dist/tools/match-visas.js

@@ -0,0 +1,83 @@
+import { z } from "zod/v3";
+import { fetchJson } from "../api.js";
+const inputSchema = {
+    citizenship: z.string(),
+    current_country: z.string().optional(),
+    education: z
+        .enum(["high_school", "associate", "bachelor", "master", "phd", "professional"])
+        .optional(),
+    work_years: z.number().int().min(0).max(60).optional(),
+    work_field: z.string().optional(),
+    income_usd: z.number().int().min(0).optional(),
+    goal: z
+        .enum([
+        "work_tech",
+        "start_company",
+        "study_work",
+        "relocate_family",
+        "digital_nomad",
+    ])
+        .optional(),
+    target_countries: z.array(z.string()).optional(),
+    timeline: z.enum(["asap", "6months", "1year", "2plus"]).optional(),
+    age: z.number().int().min(15).max(80).optional(),
+};
+const incomeRange = (income) => {
+    if (income == null)
+        return "";
+    if (income < 30_000)
+        return "under_30k";
+    if (income < 60_000)
+        return "30k_60k";
+    if (income < 100_000)
+        return "60k_100k";
+    if (income < 150_000)
+        return "100k_150k";
+    return "over_150k";
+};
+export function registerMatchVisas(server) {
+    server.registerTool("transita_match_visas", {
+        title: "Match visas",
+        description: "Score a user's profile against every visa pathway Transita supports. Returns the top matches ranked by eligibility, with timeline, cost, and links to official sources. EU citizens automatically surface freedom-of-movement options first.",
+        inputSchema,
+    }, async (args) => {
+        const quizAnswers = {
+            citizenship: args.citizenship,
+            currentCountry: args.current_country ?? "",
+            education: args.education ?? "",
+            workYears: args.work_years != null ? String(args.work_years) : "",
+            workField: args.work_field ?? "",
+            income: incomeRange(args.income_usd),
+            goal: args.goal ?? "",
+            targetCountries: args.target_countries ?? [],
+            timeline: args.timeline ?? "",
+        };
+        const data = await fetchJson("/api/match/fast", {
+            method: "POST",
+            body: quizAnswers,
+        });
+        const slim = data.results.slice(0, 6).map((r) => ({
+            id: r.id,
+            visa: `${r.countryFlag} ${r.countryName} — ${r.visaName} (${r.visaCode})`,
+            score: r.matchScore,
+            timeline: r.timelineMonths,
+            cost: r.costRange,
+            pathToPR: r.pathToPR ?? false,
+            officialUrl: r.officialUrl,
+            officialSource: r.officialSource,
+            description: r.description,
+            details_url: `https://transita.app/visa/${r.id}`,
+        }));
+        const summary = slim.length
+            ? `Top ${slim.length} visa matches for a ${args.citizenship} citizen:\n` +
+                slim
+                    .map((m, i) => `${i + 1}. ${m.visa} — score ${m.score}/100, ~${m.timeline}, ${m.cost}${m.pathToPR ? " · path to PR" : ""}\n   ${m.description}\n   Official: ${m.officialUrl ?? "n/a"}\n   Full details: ${m.details_url}`)
+                    .join("\n\n")
+            : "No visa matches above the minimum score threshold for this profile.";
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: { matches: slim, count: slim.length },
+        };
+    });
+}
+//# sourceMappingURL=match-visas.js.map

package/dist/tools/match-visas.js.map

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

package/dist/tools/search-by-nationality.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchByNationality(server: McpServer): void;

package/dist/tools/search-by-nationality.js

@@ -0,0 +1,78 @@
+import { z } from "zod/v3";
+import { fetchJson } from "../api.js";
+const SLUG_OVERRIDES = {
+    america: "american",
+    americans: "american",
+    india: "indian",
+    indians: "indian",
+    brazil: "brazilian",
+    brazilians: "brazilian",
+    uk: "british",
+    britain: "british",
+    britons: "british",
+    germany: "german",
+    germans: "german",
+    france: "french",
+    spain: "spanish",
+};
+function nationalityToSlug(input) {
+    const normalized = input.trim().toLowerCase();
+    if (SLUG_OVERRIDES[normalized])
+        return SLUG_OVERRIDES[normalized];
+    return normalized;
+}
+export function registerSearchByNationality(server) {
+    server.registerTool("transita_search_by_nationality", {
+        title: "Search visas by nationality",
+        description: "Show top destinations and recommended visa pathways for citizens of a given country. Ideal first stop for the question 'Where should I move?'. Returns 4-6 destinations with the best-fit visa for each, key stats, and FAQ. Falls back gracefully if a slug isn't yet curated.",
+        inputSchema: {
+            nationality: z
+                .string()
+                .describe("Nationality adjective (e.g. 'Indian') or country (e.g. 'India'). Case-insensitive."),
+        },
+    }, async ({ nationality }) => {
+        const slug = nationalityToSlug(nationality);
+        try {
+            const data = await fetchJson(`/api/nationality/${encodeURIComponent(slug)}`);
+            const n = data.nationality;
+            const lines = [
+                `${n.flag} ${n.headline}`,
+                "",
+                n.intro,
+                "",
+                "Top destinations:",
+                ...n.topDestinations.map((d, i) => `  ${i + 1}. ${d.flag} ${d.country} — ${d.visaName}\n     ${d.why}`),
+                "",
+                ...(n.keyStats.length
+                    ? ["Key stats:", ...n.keyStats.map((s) => `  ${s.value} — ${s.label}`), ""]
+                    : []),
+                ...(n.faq.length
+                    ? ["FAQ:", ...n.faq.slice(0, 3).map((f) => `  Q: ${f.q}\n  A: ${f.a}`)]
+                    : []),
+                "",
+                `More: https://transita.app/from/${n.slug}`,
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                structuredContent: data,
+            };
+        }
+        catch (err) {
+            const index = await fetchJson(`/api/nationalities`);
+            const available = index.nationalities
+                .map((n) => `${n.flag} ${n.nationality} (${n.slug})`)
+                .join(", ");
+            const message = `No curated guidance for "${nationality}" yet. ` +
+                `Try transita_match_visas with citizenship="${nationality}" instead, or pick a curated nationality:\n\n${available}`;
+            return {
+                content: [{ type: "text", text: message }],
+                isError: false,
+                structuredContent: {
+                    error: err.message,
+                    availableSlugs: index.nationalities.map((n) => n.slug),
+                },
+            };
+        }
+    });
+}
+//# sourceMappingURL=search-by-nationality.js.map

package/dist/tools/search-by-nationality.js.map

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

package/dist/tools/visa-details.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerVisaDetails(server: McpServer): void;

package/dist/tools/visa-details.js

@@ -0,0 +1,47 @@
+import { z } from "zod/v3";
+import { fetchJson } from "../api.js";
+export function registerVisaDetails(server) {
+    server.registerTool("transita_visa_details", {
+        title: "Visa details",
+        description: "Fetch full details for a single visa pathway: eligibility category, processing time, fees, validity, PR timeline, and a free preview of the document checklist (lead time, ancillary cost, first section). The full multi-section checklist is part of Transita's $9 paid action plan.",
+        inputSchema: {
+            visa_id: z
+                .string()
+                .describe("Transita visa id, e.g. 'us-o1a', 'es-digital-nomad'. Use transita_match_visas or the transita://visas resource to discover ids."),
+        },
+    }, async ({ visa_id }) => {
+        const data = await fetchJson(`/api/visa/${encodeURIComponent(visa_id)}`);
+        const v = data.visa;
+        const c = data.checklistPreview;
+        const lines = [
+            `${v.countryFlag} ${v.countryName} — ${v.name} (${v.code})`,
+            v.description,
+            "",
+            `Category: ${v.category}`,
+            `Processing time: ${v.processingTimeMonths.min}-${v.processingTimeMonths.max} months`,
+            `Government fee: $${v.costUSD} USD`,
+            `Validity: ${v.validityYears} year(s)`,
+            `Path to PR: ${v.pathToPR ? "yes" : "no"}${v.prTimelineYears != null ? ` (~${v.prTimelineYears} years)` : ""}`,
+            v.requiresEmployerSponsor ? `Requires employer sponsor: yes` : null,
+            `Official source: ${v.officialUrl}`,
+            "",
+            "Document checklist preview (free):",
+            `  Start preparing: ${c.leadTime}`,
+            `  Ancillary cost: ${c.ancillaryCost}`,
+            c.firstSection
+                ? `  First section — ${c.firstSection.label}:\n` +
+                    c.firstSection.docs
+                        .map((d) => `    • ${d.name} — ${d.where}${d.time ? ` (${d.time})` : ""}${d.cost ? `, ${d.cost}` : ""}`)
+                        .join("\n")
+                : null,
+            c.totalSections > 1
+                ? `  ${c.totalSections - 1} more section(s) available in the full plan: ${c.paidPlanUrl}`
+                : null,
+        ].filter(Boolean);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            structuredContent: data,
+        };
+    });
+}
+//# sourceMappingURL=visa-details.js.map

package/dist/tools/visa-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visa-details.js","sourceRoot":"","sources":["../../src/tools/visa-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQtC,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,wRAAwR;QAC1R,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CACP,iIAAiI,CAClI;SACJ;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,MAAM,SAAS,CAC1B,aAAa,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC3C,CAAC;QAEF,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAChC,MAAM,KAAK,GAAG;YACZ,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG;YAC3D,CAAC,CAAC,WAAW;YACb,EAAE;YACF,aAAa,CAAC,CAAC,QAAQ,EAAE;YACzB,oBAAoB,CAAC,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,CAAC,oBAAoB,CAAC,GAAG,SAAS;YACrF,oBAAoB,CAAC,CAAC,OAAO,MAAM;YACnC,aAAa,CAAC,CAAC,aAAa,UAAU;YACtC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9G,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,IAAI;YACnE,oBAAoB,CAAC,CAAC,WAAW,EAAE;YACnC,EAAE;YACF,oCAAoC;YACpC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;YAClC,qBAAqB,CAAC,CAAC,aAAa,EAAE;YACtC,CAAC,CAAC,YAAY;gBACZ,CAAC,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,KAAK,KAAK;oBAC9C,CAAC,CAAC,YAAY,CAAC,IAAI;yBAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;yBACvG,IAAI,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,IAAI;YACR,CAAC,CAAC,aAAa,GAAG,CAAC;gBACjB,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,CAAC,gDAAgD,CAAC,CAAC,WAAW,EAAE;gBACzF,CAAC,CAAC,IAAI;SACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,iBAAiB,EAAE,IAA0C;SAC9D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Mirror of the Transita web app types we consume from the public
+ * JSON API. Kept narrow on purpose — only the fields the MCP server
+ * actually surfaces. Source of truth lives in apps/web/src/lib.
+ */
+export interface VisaEntry {
+    id: string;
+    country: string;
+    countryName: string;
+    countryFlag: string;
+    name: string;
+    code: string;
+    category: string;
+    description: string;
+    processingTimeMonths: {
+        min: number;
+        max: number;
+    };
+    costUSD: number;
+    validityYears: number;
+    pathToPR: boolean;
+    prTimelineYears?: number;
+    pointsBased: boolean;
+    officialUrl: string;
+    targetGoals: string[];
+    requiresEmployerSponsor?: boolean;
+}
+export interface ChecklistDoc {
+    name: string;
+    where: string;
+    url?: string;
+    time?: string;
+    cost?: string;
+    selfHeld?: boolean;
+}
+export interface ChecklistSection {
+    label: string;
+    docs: ChecklistDoc[];
+}
+export interface ChecklistPreview {
+    leadTime: string;
+    ancillaryCost: string;
+    totalSections: number;
+    firstSection: ChecklistSection | null;
+    paidPlanUrl: string;
+}
+export interface VisaPath {
+    id: string;
+    country: string;
+    countryName: string;
+    countryFlag: string;
+    visaName: string;
+    visaCode: string;
+    matchScore: number;
+    timelineMonths: string;
+    costRange: string;
+    description: string;
+    highlights?: string[];
+    blockers?: string[];
+    pathToPR?: boolean;
+    prTimelineYears?: number;
+    officialUrl?: string;
+    officialSource?: string;
+    dataUpdatedAt?: string;
+}
+export interface CityCostOfLiving {
+    city: string;
+    monthlyUSD: string;
+    note?: string;
+}
+export interface ScoreDimension {
+    label: string;
+    score: number;
+}
+export interface CountryConfig {
+    code: string;
+    iso2: string;
+    name: string;
+    flag: string;
+    slug: string;
+    isEUMember: boolean;
+    isActive: boolean;
+    cardDescription: string;
+    guideIntro: string;
+    guideHighlights: string[];
+    scoreDimensions: ScoreDimension[];
+    cities: CityCostOfLiving[];
+    drawbacks: string[];
+    prTimelineYears: number;
+    citizenshipTimelineYears: number;
+    visaCount?: number;
+}
+export interface NationalityPageData {
+    slug: string;
+    nationality: string;
+    country: string;
+    flag: string;
+    headline: string;
+    intro: string;
+    topDestinations: {
+        country: string;
+        flag: string;
+        visaName: string;
+        why: string;
+    }[];
+    keyStats: {
+        value: string;
+        label: string;
+    }[];
+    faq: {
+        q: string;
+        a: string;
+    }[];
+    metaDescription: string;
+}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Mirror of the Transita web app types we consume from the public
+ * JSON API. Kept narrow on purpose — only the fields the MCP server
+ * actually surfaces. Source of truth lives in apps/web/src/lib.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@transita/mcp-server",
+  "version": "0.1.0",
+  "mcpName": "io.github.snenenenenenene/transita-mcp-server",
+  "description": "Model Context Protocol server for Transita — visa eligibility matcher, country comparisons, and immigration intelligence inside Claude Desktop, Cursor, Cline, and any MCP-compatible AI assistant.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "transita-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepublishOnly": "bun run build",
+    "lint": "echo 'no-op'",
+    "type-check": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "transita",
+    "immigration",
+    "visa",
+    "claude",
+    "ai-tools"
+  ],
+  "homepage": "https://transita.app/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/snenenenenenene/mova.git",
+    "directory": "packages/mcp-server"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5"
+  }
+}