@selextract/mcp-selextract 0.4.0 → 0.5.0

package/README.md

@@ -6,11 +6,12 @@ If you can run `npx`, you can add it to your MCP client with one config entry.
 
 ## Env
 
-- `SELEXTRACT_API_URL`
-  - Examples: `http://localhost:8246`, `https://api.selextract.com`, `https://api.selextract.com/api`
-  - This server normalizes it to end with `/api` (if you pass `/api/v1`, it will trim back to `/api`).
 - `SELEXTRACT_API_KEY` (your `sk_...` user API key)
   - Legacy alias: `SELEXTRACT_API_TOKEN`
+- Optional: `SELEXTRACT_API_URL` (defaults to `https://app.selextract.com/api`)
+  - Use this only if you are pointing at a local dev server or a self-hosted endpoint.
+  - Examples: `http://localhost:8246`, `https://app.selextract.com/api`
+  - This server normalizes it to end with `/api` (if you pass `/api/v1`, it will trim back to `/api`).
 - Optional: `SELEXTRACT_TIMEOUT_MS` (default: `30000`)
 - Optional: `SELEXTRACT_MAX_RESPONSE_CHARS` (default: `30000`)
 - Optional: `SELEXTRACT_ENV_FILE` (default: `.env`)
@@ -32,7 +33,6 @@ Add this to your MCP config (keep keys in env vars if possible):
       "command": "npx",
       "args": ["-y", "--package", "@selextract/mcp-selextract", "mcp-selextract"],
       "env": {
-        "SELEXTRACT_API_URL": "http://localhost:8246",
         "SELEXTRACT_API_KEY": "sk_REPLACE_ME"
       }
     }
@@ -40,6 +40,14 @@ Add this to your MCP config (keep keys in env vars if possible):
 }
 ```
 
+If you want to point at a local dev server, add:
+
+```json
+{
+  "SELEXTRACT_API_URL": "http://localhost:8246"
+}
+```
+
 ## What you can do
 
 Typical flow:
@@ -53,8 +61,6 @@ Typical flow:
 Useful extras:
 
 - Draft cleanup: `task_draft_delete`
-- Task repair (self-healing rebuild): `task_repair`
-- Recipe versioning (rollback/switch): `task_recipe_versions`, `task_set_recipe_version`
 - Authenticated scraping: access profile tools (create/list/update/delete/build-session)
 - Run lifecycle: `run_get`, `run_list`, `run_stop`, `run_delete`
 

package/dist/config.js

@@ -1,6 +1,8 @@
 import { z } from 'zod';
+const DEFAULT_SELEXTRACT_API_URL = 'https://app.selextract.com/api';
 const EnvSchema = z.object({
-    SELEXTRACT_API_URL: z.string().min(1),
+    // Optional because Selextract Cloud is the default.
+    SELEXTRACT_API_URL: z.string().min(1).optional().default(DEFAULT_SELEXTRACT_API_URL),
     SELEXTRACT_API_KEY: z.string().min(1).optional(),
     // Legacy alias (kept for older configs).
     SELEXTRACT_API_TOKEN: z.string().min(1).optional(),

package/dist/resources.js

@@ -31,16 +31,16 @@ export async function readResource(opts) {
             '',
             'This MCP server exposes only **basic** operations for:',
             '- Creating AI-built tasks (draft → publish)',
-            '- Repairing tasks (rebuild recipe)',
-            '- Switching task recipe versions (rollback)',
             '- Running tasks (create/get/list/stop/delete runs)',
             '- Managing access profiles (for logged-in/session scraping)',
             '',
             'It intentionally does **not** expose trace/scratchpad or other deep debugging data.',
             '',
             'Required env vars:',
-            '- SELEXTRACT_API_URL',
             '- SELEXTRACT_API_KEY (or legacy SELEXTRACT_API_TOKEN)',
+            '',
+            'Optional env vars:',
+            '- SELEXTRACT_API_URL (defaults to https://app.selextract.com/api)',
         ].join('\n');
         return {
             contents: [{ uri: opts.uri, mimeType: 'text/markdown', text: value }],

package/dist/tools.js

@@ -31,9 +31,6 @@ const TaskCreateInputSchema = z.preprocess((raw) => {
         ...value,
         access_profile_id: value.access_profile_id ?? value.accessProfileId,
         field_mode: value.field_mode ?? value.fieldMode ?? value.mode,
-        build_mode: value.build_mode ?? value.buildMode,
-        script_source: value.script_source ?? value.scriptSource,
-        recipe_override: value.recipe_override ?? value.recipeOverride,
         max_preview_rows: value.max_preview_rows ?? value.maxPreviewRows,
         goal: value.goal ?? value.description,
     };
@@ -42,13 +39,9 @@ const TaskCreateInputSchema = z.preprocess((raw) => {
     url: z.string().url(),
     access_profile_id: z.string().uuid().optional(),
     field_mode: z.enum(['auto', 'manual']).optional(),
-    build_mode: z.enum(['selectors', 'flow', 'code', 'auto']).optional().default('auto'),
-    script_source: z.string().min(1).optional(),
-    recipe_override: z.any().optional(),
     goal: z.string().min(1).optional(),
     fields: z.array(FieldSchema).optional(),
     max_preview_rows: z.number().int().positive().optional().default(10),
-    advanced: z.boolean().optional().default(false),
 })
     .superRefine((data, ctx) => {
     const effectiveFieldMode = data.field_mode ?? (data.fields?.length ? 'manual' : 'auto');
@@ -79,39 +72,6 @@ const TaskPublishInputSchema = z.preprocess((raw) => {
 const TaskDraftDeleteInputSchema = z.object({
     preview_id: z.string().uuid(),
 });
-const TaskRepairInputSchema = z.preprocess((raw) => {
-    if (!raw || typeof raw !== 'object')
-        return raw;
-    const value = raw;
-    return {
-        ...value,
-        hint: value.hint ?? value.what_is_wrong ?? value.whatIsWrong ?? value.issue,
-    };
-}, z
-    .object({
-    task_id: z.string().uuid(),
-    hint: z.string().min(1).max(2000).optional(),
-    force: z.boolean().optional().default(false),
-})
-    .passthrough());
-const TaskRecipeVersionsInputSchema = z.object({
-    task_id: z.string().uuid(),
-});
-const TaskSetRecipeVersionInputSchema = z
-    .object({
-    task_id: z.string().uuid(),
-    recipe_version_id: z.string().uuid().optional(),
-    version: z.coerce.number().int().positive().optional(),
-})
-    .superRefine((data, ctx) => {
-    if (!data.recipe_version_id && !data.version) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: 'Provide recipe_version_id or version.',
-            path: ['recipe_version_id'],
-        });
-    }
-});
 const AccessProfileHeaderSchema = z.object({
     name: z.string().min(1),
     value: z.string().min(1),
@@ -185,9 +145,6 @@ export const ToolInputs = {
     task_build_status: TaskBuildStatusInputSchema,
     task_publish: TaskPublishInputSchema,
     task_draft_delete: TaskDraftDeleteInputSchema,
-    task_repair: TaskRepairInputSchema,
-    task_recipe_versions: TaskRecipeVersionsInputSchema,
-    task_set_recipe_version: TaskSetRecipeVersionInputSchema,
     // Runs
     run_create: z.object({
         task_id: z.string().uuid(),
@@ -241,13 +198,9 @@ export function toolDefinitions() {
                     url: { type: 'string', description: 'The page to analyze.' },
                     access_profile_id: { type: 'string', description: 'Optional access profile ID for logged-in/session scraping.' },
                     field_mode: { type: 'string', enum: ['auto', 'manual'], description: 'auto = infer fields; manual = use provided fields.' },
-                    build_mode: { type: 'string', enum: ['selectors', 'flow', 'code', 'auto'], description: 'How to build the draft (default: auto).' },
-                    script_source: { type: 'string', description: 'Optional Playwright script source (code mode). If provided, the server previews this exact script.' },
-                    recipe_override: { type: 'object', description: 'Optional base recipe to reuse when previewing custom scripts (keeps flow/dom settings).' },
                     goal: { type: 'string', description: 'Optional short description of what to extract (helps in auto mode).' },
                     fields: { type: 'array', items: { type: 'object' }, description: 'Fields to extract (required in manual mode).' },
                     max_preview_rows: { type: 'number', description: 'How many sample rows to generate in the preview (default: 10).' },
-                    advanced: { type: 'boolean', description: 'Allow more complex extraction strategies (may take longer).' },
                 },
                 required: ['url'],
             },
@@ -283,41 +236,6 @@ export function toolDefinitions() {
                 required: ['preview_id'],
             },
         },
-        {
-            name: 'task_repair',
-            description: 'Repair a saved task by re-running the agent builder (creates a new recipe version and updates the task in place). Returns build_job_id.',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    task_id: { type: 'string', description: 'Task ID.' },
-                    hint: { type: 'string', description: 'Optional note about what is wrong (helps steer the repair).' },
-                    force: { type: 'boolean', description: 'If true, queue even if a build is already in progress.' },
-                },
-                required: ['task_id'],
-            },
-        },
-        {
-            name: 'task_recipe_versions',
-            description: 'List recipe versions for a task (for rollback/version switching).',
-            inputSchema: {
-                type: 'object',
-                properties: { task_id: { type: 'string', description: 'Task ID.' } },
-                required: ['task_id'],
-            },
-        },
-        {
-            name: 'task_set_recipe_version',
-            description: 'Switch a task to use a specific recipe version (by recipe_version_id or by version number).',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    task_id: { type: 'string', description: 'Task ID.' },
-                    recipe_version_id: { type: 'string', description: 'Recipe version ID.' },
-                    version: { type: 'number', description: 'Recipe version number (1, 2, 3, ...).' },
-                },
-                required: ['task_id'],
-            },
-        },
         // Runs
         {
             name: 'run_create',
@@ -472,13 +390,9 @@ export function toolHandlers(api, maxChars) {
                     url: input.url,
                     access_profile_id: input.access_profile_id,
                     field_mode: effectiveFieldMode,
-                    build_mode: input.build_mode,
-                    ...(input.script_source ? { script_source: input.script_source } : {}),
-                    ...(input.recipe_override ? { recipe_override: input.recipe_override } : {}),
                     goal: input.goal,
                     fields: input.fields,
                     maxPreviewRows: input.max_preview_rows,
-                    advanced: input.advanced,
                     debug: false,
                 },
             });
@@ -523,35 +437,6 @@ export function toolHandlers(api, maxChars) {
             });
             return asTextResult(result, maxChars);
         },
-        task_repair: async (raw) => {
-            const input = ToolInputs.task_repair.parse(raw);
-            const result = await api.request({
-                method: 'POST',
-                path: `/v1/agent/tasks/${input.task_id}/repair`,
-                body: input.hint || input.force ? { hint: input.hint, force: input.force } : {},
-            });
-            return asTextResult(result, maxChars);
-        },
-        task_recipe_versions: async (raw) => {
-            const input = ToolInputs.task_recipe_versions.parse(raw);
-            const result = await api.request({
-                method: 'GET',
-                path: `/v1/tasks/${input.task_id}/recipe-versions`,
-            });
-            return asTextResult(result, maxChars);
-        },
-        task_set_recipe_version: async (raw) => {
-            const input = ToolInputs.task_set_recipe_version.parse(raw);
-            const result = await api.request({
-                method: 'POST',
-                path: `/v1/tasks/${input.task_id}/recipe-version`,
-                body: {
-                    recipe_version_id: input.recipe_version_id,
-                    version: input.version,
-                },
-            });
-            return asTextResult(result, maxChars);
-        },
         run_create: async (raw) => {
             const input = ToolInputs.run_create.parse(raw);
             const result = await api.request({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selextract/mcp-selextract",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Selextract Cloud MCP server (local stdio) for calling the Selextract Worker API",
   "license": "UNLICENSED",
   "type": "module",