@clipform/mcp-server 1.9.2 → 1.9.4

package/README.md

@@ -77,15 +77,16 @@ You can also pass the key as a CLI flag: `npx -y @clipform/mcp-server --api-key=
 
 | Tool | Description |
 |------|-------------|
-| `clipform_render_composition` | Render a Remotion composition to MP4, PNG, or GIF (async - returns job ID) |
+| `clipform_render_composition` | Render a video composition to MP4, PNG, or GIF (async - returns job ID) |
 | `clipform_generate_tts` | Generate narration audio with word-level captions |
 | `clipform_generate_slideshow` | Create slideshow videos from images + audio (async - returns job ID) |
 | `clipform_generate_video` | Generate video from images, clips, or both synced to audio (async - returns job ID) |
 | `clipform_check_render` | Check status of an async render job |
 | `clipform_search_media` | Search royalty-free images and videos |
 | `clipform_search_music` | Search royalty-free music and ambient sounds |
-| `clipform_list_compositions` | List available Remotion compositions and prop schemas |
+| `clipform_list_compositions` | List available video compositions and prop schemas |
 | `clipform_list_assets` | List available sound effects, animations, and fonts |
+| `clipform_fetch_boundary` | Fetch a GeoJSON boundary polygon for a country, city, or region |
 
 ## Example
 

package/dist/{chunk-ESDD3WVD.js → chunk-62IK3CBP.js}

@@ -23593,7 +23593,7 @@ function registerRenderCompositionTool(server) {
     "clipform_render_composition",
     {
       title: "Render Composition",
-      description: `Render a Remotion composition to MP4, PNG, or GIF. MP4 renders use AWS Lambda in production for fast, scalable rendering. PNG and GIF render locally.
+      description: `Render a video composition to MP4, PNG, or GIF.
 
 Output formats:
 - mp4: Video file (H.264 codec, best for social media)
@@ -23685,7 +23685,7 @@ function registerListCompositionsTool(server) {
     "clipform_list_compositions",
     {
       title: "List Compositions",
-      description: `List all available Remotion compositions and their expected props schemas. Use clipform_render_composition to render them.`,
+      description: `List all available video compositions and their expected props schemas. Use clipform_render_composition to render them.`,
       inputSchema: {},
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -23695,7 +23695,7 @@ function registerListCompositionsTool(server) {
       });
       if (!result.ok) {
         if (result.status === 0 || result.status === 404) {
-          return errorResult("Remotion compositions are not available (API server may not be running). Start the API with 'npm run dev --workspace=apps/api'.");
+          return errorResult("Video compositions are not available (API server may not be running). Start the API with 'npm run dev --workspace=apps/api'.");
         }
         return errorResult(result.error);
       }
@@ -23947,6 +23947,118 @@ Returns the current status and, when complete, the output URL. If still renderin
   );
 }
 
+// src/tools/fetch-boundary.ts
+var NOMINATIM_BASE = "https://nominatim.openstreetmap.org/search";
+var USER_AGENT = "Clipform/1.0 (https://clipform.io)";
+function polygonArea(ring) {
+  let area = 0;
+  for (let i = 0; i < ring.length - 1; i++) {
+    area += ring[i][0] * ring[i + 1][1];
+    area -= ring[i + 1][0] * ring[i][1];
+  }
+  return Math.abs(area / 2);
+}
+function simplifyRing(ring, maxPoints) {
+  if (ring.length <= maxPoints) return ring;
+  const step = Math.max(1, Math.floor(ring.length / maxPoints));
+  const result = [];
+  for (let i = 0; i < ring.length - 1; i += step) {
+    result.push(ring[i]);
+  }
+  result.push(ring[ring.length - 1]);
+  return result;
+}
+function registerFetchBoundaryTool(server) {
+  server.registerTool(
+    "clipform_fetch_boundary",
+    {
+      title: "Fetch Geographic Boundary",
+      description: `Fetch a GeoJSON boundary polygon for a country, city, or region. Returns simplified GeoJSON ready to use as the 'boundary' prop in GlobeToCity/CityToGlobe compositions.
+
+Use mainlandOnly to exclude small islands and overseas territories (e.g. Corsica for France, Hawaii for USA).`,
+      inputSchema: {
+        query: external_exports.string().describe("Place name (e.g. 'France', 'Paris', 'Tokyo', 'Brazil')"),
+        type: external_exports.enum(["country", "city", "state", "region"]).default("country").describe("Type of place to search for"),
+        mainlandOnly: external_exports.boolean().default(true).describe("Keep only the largest landmass, excluding small islands and overseas territories"),
+        maxPoints: external_exports.number().default(500).describe("Maximum points per polygon ring for simplification (default 500, lower = smaller payload)")
+      },
+      annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+    },
+    async ({ query, type, mainlandOnly, maxPoints }) => {
+      const params = new URLSearchParams({
+        format: "geojson",
+        polygon_geojson: "1",
+        polygon_threshold: "0.001",
+        limit: "1"
+      });
+      if (type === "country") {
+        params.set("country", query);
+      } else if (type === "city") {
+        params.set("city", query);
+      } else {
+        params.set("q", query);
+      }
+      const url = `${NOMINATIM_BASE}?${params}`;
+      const response = await fetch(url, {
+        headers: { "User-Agent": USER_AGENT }
+      });
+      if (!response.ok) {
+        return errorResult(`Nominatim API error: ${response.status} ${response.statusText}`);
+      }
+      const data = await response.json();
+      if (!data.features?.length) {
+        return errorResult(`No boundary found for "${query}" (type: ${type}). Try a different name or type.`);
+      }
+      const feature = data.features[0];
+      let geometry = feature.geometry;
+      if (geometry.type === "MultiPolygon" && mainlandOnly) {
+        const withArea = geometry.coordinates.map((poly, i) => ({
+          index: i,
+          coords: poly,
+          area: polygonArea(poly[0])
+        }));
+        withArea.sort((a, b) => b.area - a.area);
+        const largestArea = withArea[0].area;
+        const kept = withArea.filter((p) => p.area > largestArea * 0.05);
+        geometry = {
+          type: kept.length === 1 ? "Polygon" : "MultiPolygon",
+          coordinates: kept.length === 1 ? kept[0].coords : kept.map((p) => p.coords)
+        };
+      }
+      if (geometry.type === "Polygon") {
+        geometry.coordinates = geometry.coordinates.map(
+          (ring) => simplifyRing(ring, maxPoints)
+        );
+      } else if (geometry.type === "MultiPolygon") {
+        geometry.coordinates = geometry.coordinates.map(
+          (poly) => poly.map((ring) => simplifyRing(ring, maxPoints))
+        );
+      }
+      const result = {
+        type: "Feature",
+        properties: { name: feature.properties.display_name },
+        geometry
+      };
+      const geojsonStr = JSON.stringify(result);
+      const sizeKb = (geojsonStr.length / 1024).toFixed(1);
+      return textResult(
+        [
+          `Boundary fetched for: ${feature.properties.display_name}`,
+          `Geometry: ${geometry.type}`,
+          `Size: ${sizeKb} KB`,
+          mainlandOnly ? `Mainland filter: applied (islands < 5% of largest landmass removed)` : `Mainland filter: off`,
+          ``,
+          `Use this as the boundary.geojson prop in GlobeToCity:`,
+          ``,
+          "```json",
+          geojsonStr,
+          "```"
+        ].join("\n")
+      );
+    }
+  );
+}
+
 // src/lib/session-context.ts
 async function getSessionContext() {
   const result = await callApi("/me", { method: "GET" });
@@ -24673,6 +24785,7 @@ function createServer() {
   registerListCompositionsTool(server);
   registerListAssetsTool(server);
   registerCheckRenderTool(server);
+  registerFetchBoundaryTool(server);
   registerPrompts(server);
   registerResources(server);
   return server;
@@ -24683,4 +24796,4 @@ export {
   setApiKey,
   createServer
 };
-//# sourceMappingURL=chunk-ESDD3WVD.js.map
+//# sourceMappingURL=chunk-62IK3CBP.js.map