← Back to Skills Marketplace

Filtrix Image Gen

Name: Filtrix Image Gen
Author: lumenclaw-cloud

by lumenclaw-cloud · GitHub ↗ · v1.0.2 · MIT-0

cross-platform ⚠ suspicious

518

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install filtrix-image-gen

Description

Generate and edit images through Filtrix Remote MCP. Use when users ask to create images or refine existing ones. Supports gpt-image-1, nano-banana, and nano...

README (SKILL.md)

Filtrix Image Gen (MCP)

This skill is MCP-only.

Endpoint: https://mcp.filtrix.ai/mcp
Auth: Authorization: Bearer \x3CFILTRIX_MCP_API_KEY>
Primary tools:
- generate_image_text
- edit_image_text
- get_account_credits

Available MCP tools:

get_account_credits
generate_image_text
edit_image_text

Setup

Required:

FILTRIX_MCP_API_KEY

Optional:

FILTRIX_MCP_URL (default: https://mcp.filtrix.ai/mcp)

Generate

python scripts/generate.py \
  --prompt "..." \
  [--mode gpt-image-1|nano-banana|nano-banana-2] \
  [--size 1024x1024|1536x1024|1024x1536|auto] \
  [--resolution 1K|2K|4K] \
  [--search-mode] \
  [--enhance-mode] \
  [--idempotency-key KEY] \
  [--output PATH]

Edit

Use this when user wants iterative refinement, style transfer, background changes, object replacement, etc.

python scripts/edit.py \
  --prompt "make the sky sunset orange and add volumetric light" \
  (--image-path /path/to/input.png | --image-url https://...) \
  [--mode gpt-image-1|nano-banana|nano-banana-2] \
  [--size 1024x1024|1536x1024|1024x1536|auto] \
  [--resolution 1K|2K|4K] \
  [--search-mode] \
  [--enhance-mode] \
  [--idempotency-key KEY] \
  [--output PATH]

Mode Mapping

gpt-image-1: general quality route
nano-banana: fast generation route
nano-banana-2: advanced generation route

Recommended Workflow

First pass with generate_image_text (scripts/generate.py).
Use edit_image_text (scripts/edit.py) for targeted changes.
Use a new idempotency_key for each new edit intent.

Idempotency

idempotency_key prevents duplicate billing on retries. If omitted, scripts auto-generate one UUID-based key.

References

Usage Guidance

Before installing or using this skill: (1) don't set or expose your Filtrix API key globally until you trust the source—the SKILL.md requires FILTRIX_MCP_API_KEY but the registry metadata omits it; verify which env var your deployment will inject. (2) Note the scripts also accept an undocumented MCP_API_KEY fallback—ask the author to document/fix this. (3) Running the scripts will send images (including anything you pass via --image-path or --image-url) to https://mcp.filtrix.ai/mcp and will download returned signed URLs; avoid sending sensitive images unless you trust Filtrix. (4) The package contains plain Python scripts (no install fetches), so inspect them or run them in a sandboxed environment and monitor network/credential usage. (5) Ask the publisher to correct the registry metadata to declare the required env var (FILTRIX_MCP_API_KEY) and clarify the MCP_API_KEY fallback before trusting the skill.

Capability Analysis

Type: OpenClaw Skill Name: filtrix-image-gen Version: 1.0.2 The skill bundle provides a legitimate interface for the Filtrix AI image generation and editing service via a remote Model Context Protocol (MCP) endpoint (mcp.filtrix.ai). The Python scripts (scripts/generate.py and scripts/edit.py) use standard libraries to perform authenticated API requests, handle image data (base64 and URLs), and save results to the local filesystem as described in the documentation. No evidence of malicious intent, data exfiltration, or unauthorized execution was found.

Capability Assessment

ℹ Purpose & Capability

The skill name/description match the included scripts and MCP usage: both generate and edit images via a Filtrix MCP endpoint. However the registry metadata lists no required environment variables or primary credential, while SKILL.md and the scripts clearly require an API key (FILTRIX_MCP_API_KEY). This mismatch is inconsistent and should be corrected.

ℹ Instruction Scope

SKILL.md and the scripts limit behavior to calling the Filtrix MCP endpoint and downloading returned images or user-provided image URLs. The scripts read local image files when provided, base64-encode them, send them to the MCP endpoint, and write result images to /tmp (or a user-specified path). The scripts also accept an undocumented fallback env var (MCP_API_KEY). No instructions attempt to read unrelated system files or other credentials, but the acceptance of arbitrary input image URLs means user-provided URLs (and image contents) will be retrieved and transmitted to the remote MCP service—consider privacy implications.

✓ Install Mechanism

No install spec; code is included as plain Python scripts. This is the lower-risk model (nothing is automatically fetched or executed at install time), but you still run the bundled scripts locally which will make outbound network calls.

⚠ Credentials

The runtime requires a Filtrix API key (FILTRIX_MCP_API_KEY) but the registry metadata omitted this. The scripts also accept MCP_API_KEY as an undocumented alias. Requesting a single service API key is proportionate for this functionality, but the metadata mismatch and undocumented fallback increase the risk of accidental credential exposure or misconfiguration.

✓ Persistence & Privilege

The skill is not always-enabled, does not request unusual system privileges, and does not modify other skills or global agent settings. It runs only when invoked and writes output files to user-specified paths (default /tmp).

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install filtrix-image-gen
After installation, invoke the skill by name or use /filtrix-image-gen
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.2

- Migrated to Filtrix Remote MCP; now uses a unified endpoint for all image generation and editing. - Added support for gpt-image-1, nano-banana, and nano-banana-2 modes via MCP. - Removed support and documentation for direct OpenAI, Gemini, and fal.ai integration. - Introduced new references for MCP tools and available image generation modes. - Added clearer setup, idempotency key usage, and recommended workflow guidance.

v1.0.1

Initial release

v1.0.0

Initial release

Metadata

Slug filtrix-image-gen

Version 1.0.2

License MIT-0

All-time Installs 3

Active Installs 3

Total Versions 3

Frequently Asked Questions

What is Filtrix Image Gen?

Generate and edit images through Filtrix Remote MCP. Use when users ask to create images or refine existing ones. Supports gpt-image-1, nano-banana, and nano... It is an AI Agent Skill for Claude Code / OpenClaw, with 518 downloads so far.

How do I install Filtrix Image Gen?

Run "/install filtrix-image-gen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Filtrix Image Gen free?

Yes, Filtrix Image Gen is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Filtrix Image Gen support?

Filtrix Image Gen is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Filtrix Image Gen?

It is built and maintained by lumenclaw-cloud (@lumenclaw-cloud); the current version is v1.0.2.

More Skills