grok-it-mcp 0.1.0

package/dist/tools/image-generate.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { DEFAULT_IMAGE_MODEL } from '../config/constants.js';
+import { getConfig } from '../config/env.js';
+import { cacheBase64Artifact, cacheUrlArtifact } from '../cache/artifacts.js';
+import { XaiClient } from '../xai/client.js';
+export const imageGenerateSchema = {
+    prompt: z.string().min(1),
+    model: z.string().default(DEFAULT_IMAGE_MODEL).optional(),
+    aspect_ratio: z.string().optional(),
+    resolution: z.string().optional(),
+    n: z.number().int().min(1).max(4).default(1).optional(),
+    cache: z.boolean().default(true).optional(),
+};
+export function buildImagePayload(args) {
+    return {
+        model: args.model || DEFAULT_IMAGE_MODEL,
+        prompt: args.prompt,
+        n: args.n || 1,
+        ...(args.aspect_ratio ? { aspect_ratio: args.aspect_ratio } : {}),
+        ...(args.resolution ? { resolution: args.resolution } : {}),
+    };
+}
+export async function handleImageGenerate(args, client = new XaiClient(), fetchImpl) {
+    const { data, credentials } = await client.json('/images/generations', { method: 'POST', body: buildImagePayload(args) });
+    const images = (data.data || []);
+    if (!Array.isArray(images) || images.length === 0)
+        throw new Error('xAI image response did not contain data[]');
+    const outputs = [];
+    for (const image of images) {
+        const contentType = typeof image.mime_type === 'string' ? image.mime_type : 'image/png';
+        if (args.cache !== false && typeof image.b64_json === 'string') {
+            const cached = await cacheBase64Artifact(image.b64_json, { mediaType: 'image', contentType, cacheDir: getConfig().cacheDir });
+            outputs.push({ image: cached.path, bytes: cached.bytes, content_type: cached.contentType, revised_prompt: image.revised_prompt ?? null });
+        }
+        else if (args.cache !== false && typeof image.url === 'string') {
+            const cached = await cacheUrlArtifact(image.url, { mediaType: 'image', cacheDir: getConfig().cacheDir, fetchImpl });
+            outputs.push({ image: cached.path, remote_url: image.url, bytes: cached.bytes, content_type: cached.contentType, revised_prompt: image.revised_prompt ?? null });
+        }
+        else {
+            outputs.push({ image: typeof image.url === 'string' ? image.url : null, remote_url: image.url ?? null, revised_prompt: image.revised_prompt ?? null });
+        }
+    }
+    return { images: outputs, model: data.model ?? args.model ?? DEFAULT_IMAGE_MODEL, credential_source: credentials.credentialSource };
+}
+//# sourceMappingURL=image-generate.js.map

package/dist/tools/image-generate.js.map

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

package/dist/tools/video-generate.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { XaiClient } from '../xai/client.js';
+export declare const videoGenerateSchema: {
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    image_url: z.ZodOptional<z.ZodString>;
+    reference_images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    aspect_ratio: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodOptional<z.ZodString>;
+    poll_interval_ms: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    timeout_ms: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    cache_video: z.ZodOptional<z.ZodBoolean>;
+};
+export type VideoGenerateArgs = z.objectOutputType<typeof videoGenerateSchema, z.ZodTypeAny>;
+export declare function defaultVideoModel(args: VideoGenerateArgs): string;
+export declare function buildVideoPayload(args: VideoGenerateArgs): {
+    resolution?: string | undefined;
+    aspect_ratio?: string | undefined;
+    duration?: number | undefined;
+    reference_images?: string[] | undefined;
+    image_url?: string | undefined;
+    model: string;
+    prompt: string;
+};
+export declare function handleVideoGenerate(args: VideoGenerateArgs, client?: XaiClient, fetchImpl?: typeof fetch): Promise<{
+    video: string;
+    remote_url: string;
+    request_id: string;
+    status: string;
+    bytes: number;
+    content_type: string | undefined;
+    credential_source: import("../auth/credentials.js").CredentialSource;
+    cache_warning?: undefined;
+    timeout?: undefined;
+} | {
+    video: string;
+    remote_url: string;
+    request_id: string;
+    status: string;
+    cache_warning: string;
+    credential_source: import("../auth/credentials.js").CredentialSource;
+    bytes?: undefined;
+    content_type?: undefined;
+    timeout?: undefined;
+} | {
+    video: string;
+    remote_url: string;
+    request_id: string;
+    status: string;
+    credential_source: import("../auth/credentials.js").CredentialSource;
+    bytes?: undefined;
+    content_type?: undefined;
+    cache_warning?: undefined;
+    timeout?: undefined;
+} | {
+    request_id: string;
+    status: string;
+    timeout: boolean;
+    remote_url: null;
+    video: null;
+    credential_source: import("../auth/credentials.js").CredentialSource;
+    bytes?: undefined;
+    content_type?: undefined;
+    cache_warning?: undefined;
+}>;

package/dist/tools/video-generate.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { DEFAULT_POLL_INTERVAL_MS, DEFAULT_VIDEO_IMAGE_MODEL, DEFAULT_VIDEO_MODEL, DEFAULT_VIDEO_TIMEOUT_MS } from '../config/constants.js';
+import { getConfig } from '../config/env.js';
+import { cacheUrlArtifact } from '../cache/artifacts.js';
+import { XaiClient } from '../xai/client.js';
+export const videoGenerateSchema = {
+    prompt: z.string().min(1),
+    model: z.string().optional(),
+    image_url: z.string().url().optional(),
+    reference_images: z.array(z.string().url()).optional(),
+    duration: z.number().int().min(1).max(30).optional(),
+    aspect_ratio: z.string().optional(),
+    resolution: z.string().optional(),
+    poll_interval_ms: z.number().int().min(250).max(30000).default(DEFAULT_POLL_INTERVAL_MS).optional(),
+    timeout_ms: z.number().int().min(1000).max(30 * 60_000).default(DEFAULT_VIDEO_TIMEOUT_MS).optional(),
+    cache_video: z.boolean().optional(),
+};
+export function defaultVideoModel(args) {
+    return args.model || (args.image_url || args.reference_images?.length ? DEFAULT_VIDEO_IMAGE_MODEL : DEFAULT_VIDEO_MODEL);
+}
+export function buildVideoPayload(args) {
+    return {
+        model: defaultVideoModel(args),
+        prompt: args.prompt,
+        ...(args.image_url ? { image_url: args.image_url } : {}),
+        ...(args.reference_images?.length ? { reference_images: args.reference_images } : {}),
+        ...(args.duration ? { duration: args.duration } : {}),
+        ...(args.aspect_ratio ? { aspect_ratio: args.aspect_ratio } : {}),
+        ...(args.resolution ? { resolution: args.resolution } : {}),
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function statusOf(data) {
+    const obj = data;
+    return String(obj.status || obj.state || obj.phase || '').toLowerCase();
+}
+function videoUrlOf(data) {
+    const obj = data;
+    if (typeof obj.video_url === 'string')
+        return obj.video_url;
+    if (typeof obj.url === 'string')
+        return obj.url;
+    if (Array.isArray(obj.data)) {
+        const first = obj.data[0];
+        if (typeof first?.url === 'string')
+            return first.url;
+        if (typeof first?.video_url === 'string')
+            return first.video_url;
+    }
+    return undefined;
+}
+export async function handleVideoGenerate(args, client = new XaiClient(), fetchImpl) {
+    const { data: submitted, credentials } = await client.json('/videos/generations', { method: 'POST', body: buildVideoPayload(args) });
+    const submitObj = submitted;
+    const requestId = String(submitObj.request_id || submitObj.id || '');
+    if (!requestId)
+        throw new Error('xAI video response did not contain request_id');
+    const deadline = Date.now() + (args.timeout_ms || DEFAULT_VIDEO_TIMEOUT_MS);
+    let last = submitted;
+    for (;;) {
+        const status = statusOf(last);
+        const directUrl = videoUrlOf(last);
+        if (directUrl || ['done', 'completed', 'succeeded', 'success'].includes(status)) {
+            const remoteUrl = directUrl || videoUrlOf(last);
+            if (!remoteUrl)
+                throw new Error('xAI video completed without a video URL');
+            const shouldCache = args.cache_video ?? getConfig().cacheVideoByDefault;
+            if (shouldCache) {
+                try {
+                    const cached = await cacheUrlArtifact(remoteUrl, { mediaType: 'video', cacheDir: getConfig().cacheDir, fetchImpl });
+                    return { video: cached.path, remote_url: remoteUrl, request_id: requestId, status: status || 'completed', bytes: cached.bytes, content_type: cached.contentType, credential_source: credentials.credentialSource };
+                }
+                catch (error) {
+                    return { video: remoteUrl, remote_url: remoteUrl, request_id: requestId, status: status || 'completed', cache_warning: error.message, credential_source: credentials.credentialSource };
+                }
+            }
+            return { video: remoteUrl, remote_url: remoteUrl, request_id: requestId, status: status || 'completed', credential_source: credentials.credentialSource };
+        }
+        if (['failed', 'error', 'cancelled', 'canceled'].includes(status))
+            throw new Error(`xAI video generation failed: ${JSON.stringify(last)}`);
+        if (Date.now() >= deadline)
+            return { request_id: requestId, status: status || 'pending', timeout: true, remote_url: null, video: null, credential_source: credentials.credentialSource };
+        await sleep(args.poll_interval_ms || DEFAULT_POLL_INTERVAL_MS);
+        last = (await client.json(`/videos/${encodeURIComponent(requestId)}`, { method: 'GET' })).data;
+    }
+}
+//# sourceMappingURL=video-generate.js.map

package/dist/tools/video-generate.js.map

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

package/dist/tools/x-search.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { XaiClient } from '../xai/client.js';
+export declare const xSearchSchema: {
+    query: z.ZodString;
+    model: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+    include_handles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    exclude_handles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    include_images: z.ZodOptional<z.ZodBoolean>;
+    include_videos: z.ZodOptional<z.ZodBoolean>;
+    max_results: z.ZodOptional<z.ZodNumber>;
+};
+export type XSearchArgs = z.objectOutputType<typeof xSearchSchema, z.ZodTypeAny>;
+export declare function buildXSearchPayload(args: XSearchArgs): {
+    model: string;
+    input: string;
+    tools: Record<string, unknown>[];
+};
+export declare function handleXSearch(args: XSearchArgs, client?: XaiClient): Promise<{
+    answer: string;
+    citations: any[];
+    raw_id: {} | null;
+    model: {};
+    credential_source: import("../auth/credentials.js").CredentialSource;
+    degraded: boolean;
+}>;

package/dist/tools/x-search.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { DEFAULT_X_SEARCH_MODEL } from '../config/constants.js';
+import { XaiClient, extractOutputText } from '../xai/client.js';
+export const xSearchSchema = {
+    query: z.string().min(1).describe('Search question or query for X.'),
+    model: z.string().default(DEFAULT_X_SEARCH_MODEL).optional(),
+    from_date: z.string().optional().describe('Optional inclusive YYYY-MM-DD lower date bound.'),
+    to_date: z.string().optional().describe('Optional inclusive YYYY-MM-DD upper date bound.'),
+    include_handles: z.array(z.string()).optional(),
+    exclude_handles: z.array(z.string()).optional(),
+    include_images: z.boolean().optional(),
+    include_videos: z.boolean().optional(),
+    max_results: z.number().int().min(1).max(50).optional(),
+};
+export function buildXSearchPayload(args) {
+    const tool = { type: 'x_search' };
+    if (args.from_date)
+        tool.from_date = args.from_date;
+    if (args.to_date)
+        tool.to_date = args.to_date;
+    if (args.include_handles?.length)
+        tool.included_x_handles = args.include_handles;
+    if (args.exclude_handles?.length)
+        tool.excluded_x_handles = args.exclude_handles;
+    if (args.include_images !== undefined || args.include_videos !== undefined) {
+        tool.search_parameters = { include_images: Boolean(args.include_images), include_videos: Boolean(args.include_videos) };
+    }
+    if (args.max_results)
+        tool.max_search_results = args.max_results;
+    return {
+        model: args.model || DEFAULT_X_SEARCH_MODEL,
+        input: args.query,
+        tools: [tool],
+    };
+}
+export async function handleXSearch(args, client = new XaiClient()) {
+    const { data, credentials } = await client.json('/responses', { method: 'POST', body: buildXSearchPayload(args) });
+    const obj = data;
+    return {
+        answer: extractOutputText(data),
+        citations: Array.isArray(obj.citations) ? obj.citations : [],
+        raw_id: obj.id ?? null,
+        model: obj.model ?? args.model ?? DEFAULT_X_SEARCH_MODEL,
+        credential_source: credentials.credentialSource,
+        degraded: !extractOutputText(data),
+    };
+}
+//# sourceMappingURL=x-search.js.map

package/dist/tools/x-search.js.map

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

package/dist/xai/client.d.ts

@@ -0,0 +1,25 @@
+import { ResolvedCredentials } from '../auth/credentials.js';
+export type XaiClientOptions = {
+    fetchImpl?: typeof fetch;
+    credentials?: ResolvedCredentials;
+    env?: NodeJS.ProcessEnv;
+};
+export declare class XaiError extends Error {
+    code: string;
+    status?: number | undefined;
+    details?: unknown | undefined;
+    constructor(code: string, message: string, status?: number | undefined, details?: unknown | undefined);
+}
+export declare class XaiClient {
+    private options;
+    constructor(options?: XaiClientOptions);
+    json(path: string, init?: {
+        method?: string;
+        body?: unknown;
+        timeoutMs?: number;
+    }, retrying?: boolean): Promise<{
+        data: unknown;
+        credentials: ResolvedCredentials;
+    }>;
+}
+export declare function extractOutputText(response: unknown): string;

package/dist/xai/client.js

@@ -0,0 +1,77 @@
+import { DEFAULT_XAI_BASE_URL, PACKAGE_NAME, PACKAGE_VERSION } from '../config/constants.js';
+import { resolveCredentials, redactSecret } from '../auth/credentials.js';
+import { validateInferenceBaseUrl } from '../auth/oauth.js';
+export class XaiError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, message, status, details) {
+        super(redactSecret(message));
+        this.code = code;
+        this.status = status;
+        this.details = details;
+        this.name = 'XaiError';
+    }
+}
+export class XaiClient {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async json(path, init = {}, retrying = false) {
+        const credentials = this.options.credentials || (await resolveCredentials({ fetchImpl: this.options.fetchImpl, env: this.options.env }));
+        const baseUrl = credentials.provider === 'xai-oauth' ? validateInferenceBaseUrl(credentials.baseUrl) : (credentials.baseUrl || DEFAULT_XAI_BASE_URL).replace(/\/$/, '');
+        const url = `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+        const controller = new AbortController();
+        const timer = init.timeoutMs ? setTimeout(() => controller.abort(), init.timeoutMs) : undefined;
+        const response = await (this.options.fetchImpl || fetch)(url, {
+            method: init.method || 'GET',
+            headers: {
+                accept: 'application/json',
+                'content-type': 'application/json',
+                authorization: credentials.authorization,
+                'user-agent': `${PACKAGE_NAME}/${PACKAGE_VERSION}`,
+            },
+            body: init.body === undefined ? undefined : JSON.stringify(init.body),
+            signal: controller.signal,
+        }).finally(() => timer && clearTimeout(timer));
+        const data = await response.json().catch(() => ({}));
+        if (response.status === 401 && credentials.provider === 'xai-oauth' && !retrying && !this.options.credentials) {
+            await resolveCredentials({ forceRefresh: true, fetchImpl: this.options.fetchImpl, env: this.options.env });
+            return this.json(path, init, true);
+        }
+        if (!response.ok) {
+            const msg = typeof data.error === 'string' ? data.error : `xAI request failed with HTTP ${response.status}`;
+            throw new XaiError('xai_http_error', msg, response.status, data);
+        }
+        return { data, credentials };
+    }
+}
+export function extractOutputText(response) {
+    const obj = response;
+    if (typeof obj.output_text === 'string')
+        return obj.output_text;
+    if (Array.isArray(obj.output)) {
+        const parts = [];
+        for (const item of obj.output) {
+            if (typeof item.content === 'string')
+                parts.push(item.content);
+            if (Array.isArray(item.content)) {
+                for (const content of item.content) {
+                    if (typeof content.text === 'string')
+                        parts.push(content.text);
+                }
+            }
+        }
+        if (parts.length)
+            return parts.join('\n');
+    }
+    if (Array.isArray(obj.choices)) {
+        const choice = obj.choices[0];
+        const message = choice?.message;
+        if (typeof message?.content === 'string')
+            return message.content;
+    }
+    return '';
+}
+//# sourceMappingURL=client.js.map

package/dist/xai/client.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "grok-it-mcp",
+  "version": "0.1.0",
+  "description": "Claude Code and Codex plugin wrapper around a local MCP server for Grok x_search, image generation, and video generation.",
+  "type": "module",
+  "bin": {
+    "grok-it-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "plugins"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/make-bin-executable.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "validate:plugin": "node scripts/validate-plugin.mjs",
+    "validate": "npm run typecheck && npm test && npm run build && npm run validate:plugin && npm run validate:codex-plugin",
+    "validate:codex-plugin": "node scripts/validate-codex-plugin.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "toml": "3.0.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15",
+    "yaml": "2.8.2"
+  }
+}

package/plugins/grok-it/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "grok-it",
+  "version": "0.1.0",
+  "description": "Claude Code plugin that exposes Grok x_search, image generation, and video generation through a local MCP server.",
+  "author": {
+    "name": "local"
+  },
+  "homepage": "https://github.com/local/grok-it",
+  "license": "MIT",
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json"
+}

package/plugins/grok-it/.codex-plugin/plugin.json

@@ -0,0 +1,37 @@
+{
+  "name": "grok-it",
+  "version": "0.1.0",
+  "description": "Cross-platform Claude Code and Codex plugin that exposes Grok x_search, image generation, and video generation through a local MCP server.",
+  "author": {
+    "name": "local"
+  },
+  "homepage": "https://github.com/local/grok-it",
+  "license": "MIT",
+  "keywords": [
+    "grok",
+    "xai",
+    "mcp",
+    "x-search",
+    "image-generation",
+    "video-generation"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Grok It",
+    "shortDescription": "Use Grok X search, image, and video tools in Codex.",
+    "longDescription": "Grok It bundles a shared cross-platform plugin root with a local MCP server and skill guidance so Claude Code and Codex agents can call Grok OAuth or xAI API-key backed X search, image generation, and video generation tools.",
+    "developerName": "local",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Search X with Grok for recent context.",
+      "Generate an image with Grok.",
+      "Generate a short video with Grok."
+    ]
+  }
+}

package/plugins/grok-it/.mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "grok-it": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "grok-it-mcp@0.1.0"
+      ],
+      "env": {
+        "GROK_IT_TOKEN_STORE": "${HOME}/.grok-it/auth.json",
+        "GROK_IT_CACHE_DIR": "${HOME}/.grok-it/artifacts"
+      }
+    }
+  }
+}

package/plugins/grok-it/skills/grok-tools/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: grok-tools
+description: "Use when Claude Code or Codex should call Grok/xAI MCP tools for X search, image generation, video generation, Grok OAuth login/status, or XAI_API_KEY fallback through the grok-it MCP server."
+---
+
+# Grok Tools
+
+Prefer the local `grok-it` MCP server tools rather than reimplementing xAI HTTP calls:
+
+1. Run `grok_auth_status` to check OAuth/API-key availability without exposing secrets.
+2. Run `grok_login` when OAuth setup is needed. First call returns an authorize URL plus PKCE verifier/state; second call with the callback URL completes login. Never request raw access or refresh tokens.
+3. Use `grok_x_search` for X/Twitter search with optional handle/date/media filters.
+4. Use `grok_image_generate` for image generation. It returns local cached image paths by default.
+5. Use `grok_video_generate` for video generation. It returns remote URLs by default; pass `cache_video:true` only when local video caching is desired.
+
+OAuth bearer credentials are pinned to `https://*.x.ai`; API key mode may use `XAI_BASE_URL` for compatible endpoints.

package/plugins/grok-it/skills/grok-tools/agents/openai.yaml

@@ -0,0 +1,13 @@
+interface:
+  display_name: Grok Tools
+  short_description: Call Grok X search, image generation, and video generation.
+  default_prompt: Use $grok-tools with the grok-it MCP tools for X search, image generation, video generation, and Grok OAuth/API-key auth checks.
+policy:
+  allow_implicit_invocation: true
+dependencies:
+  tools:
+    - grok_auth_status
+    - grok_login
+    - grok_x_search
+    - grok_image_generate
+    - grok_video_generate