← Back to Skills Marketplace
91
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install vatgentic
Description
Instant EU VAT validation with Lightning Bitcoin. 10 sats per lookup. No subscriptions.
Usage Guidance
This skill generally does what it says (request a VAT check and return a Lightning invoice), but there are several inconsistencies and transparency gaps you should address before using it:
- Do not provide auto-pay credentials (LNBOT_API_TOKEN / LNBOT_WALLET_ID) unless you fully trust the author and the endpoint. Auto-pay can move real funds.
- The scripts require VATGENTIC_API_URL but the registry metadata did not declare it; SKILL.md suggests an unfamiliar host (https://fair-earwig.pikapod.net). Verify the canonical service URL (official vatgentic domain) and change VATGENTIC_API_URL to a known/trusted endpoint before using.
- README mentions reading ~/.openclaw/secrets/lnbot-api.json and other workspace files, but the shipped scripts do not actually read that file. Confirm which files the skill will read in your environment and search the code for any hidden file reads before trusting it.
- If you want to use auto-pay, inspect scripts (vatgentic-validate.py / vatgentic-request.py) yourself or run them in a sandbox to confirm they only send the VAT number and invoice/payment info to the configured API and do not exfiltrate other data.
- Prefer manual payment (do not set auto-pay) during initial testing and run a few lookups with minimal amounts to confirm behavior and responses. Monitor network activity to ensure requests go to the expected host.
- Ask the publisher for clarifications: authoritative homepage/docs, reason for the fair-earwig.pikapod.net host, and an updated SKILL.md/metadata that declares required env vars and file access.
Given the mismatches (undeclared required env var, unknown endpoint, and documentation/code drift), treat this skill as suspicious until the above clarifications are provided or you confirm behavior in a sandbox.
Capability Analysis
Type: OpenClaw Skill
Name: vatgentic
Version: 1.0.0
The VatGentic skill bundle provides a utility for EU VAT validation using Lightning Network (Bitcoin) micro-payments. The Python scripts (vatgentic-request.py, vatgentic-status.py, and vatgentic-validate.py) facilitate a workflow where a user requests a VAT check, receives a Lightning invoice, and polls for the result once paid. While the scripts handle sensitive environment variables like LNBOT_API_TOKEN for automated payments, this functionality is transparently documented and directly supports the stated purpose of the tool. No evidence of data exfiltration, unauthorized execution, or malicious prompt injection was found.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the code: the Python scripts request a VAT lookup from a service URL and return Lightning invoices. Required binaries (python3, curl, jq) are plausible for the examples, though the Python scripts themselves use the requests library (curl/jq are used in SKILL.md examples). However, the package/registry metadata does not declare the VATGENTIC_API_URL environment variable that the scripts require at runtime — a metadata/instruction mismatch that can cause runtime failures and hides the actual external endpoint the skill will contact.
Instruction Scope
SKILL.md and scripts instruct the agent to POST VAT numbers and poll status at whatever VATGENTIC_API_URL is set. The Quick Start suggests VATGENTIC_API_URL='https://fair-earwig.pikapod.net' (a third-party host unrelated to the claimed vatgentic.com/docs), which is an unknown external endpoint — this is a material behavioral detail users must know. README also documents access to local workspace files and a secrets path (~/.openclaw/secrets/lnbot-api.json) but the included scripts do not actually read that path; that discrepancy suggests the documentation and code are out of sync. The scripts will send VAT numbers (and potentially invoice/payment requests) to the configured remote service — there are no instructions to read unrelated local files, but the skill does support optional auto-payment using provided ln.bot credentials.
Install Mechanism
No install spec — instruction-only with included Python scripts. Nothing is downloaded or extracted during install. This is lower-risk from an install-supply perspective, but included scripts are present on disk and will execute when used.
Credentials
The skill requires a service URL (VATGENTIC_API_URL) and optionally ln.bot credentials (LNBOT_API_TOKEN, LNBOT_WALLET_ID) for auto-pay. Those credentials are proportional to the advertised auto-pay feature. However: (1) the registry metadata did not declare VATGENTIC_API_URL as required, (2) the SKILL.md examples hard-code an unfamiliar host (fair-earwig.pikapod.net), and (3) README lists additional env vars and a local secret path which are not consistently used by the scripts. Missing/incorrect env metadata and undocumented endpoint choices reduce transparency and increase risk if users supply keys without understanding destination or behavior.
Persistence & Privilege
always is false and the skill does not request permanent platform privileges or modify other skills. However, because the skill supports automatic payments when LNBOT credentials are provided and agent invocation is allowed (default), an agent could perform real Lightning payments if given credentials and invoked autonomously. Combine that with the unknown external endpoint and you should be cautious about granting auto-pay credentials or enabling autonomous invocation for this skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vatgentic - After installation, invoke the skill by name or use
/vatgentic - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of VatGentic – lightning-fast EU VAT validation with Bitcoin Lightning payments.
- Validate EU VAT numbers instantly for just 10 sats per lookup.
- No subscriptions or sign-ups; pay-per-use via the Lightning Network.
- Returns validity, company name, address, and VAT number details.
- Easy integration with API endpoints and Python code samples provided.
- Works with all 27 EU member countries.
- Requires Lightning Bitcoin, curl, jq, and Python 3.
v0.3.0
**Command-line interface overhaul and backend configuration update**
- Introduced a new Python CLI entry point (`__main__.py`) for streamlined usage: `python3 -m vatgentic ...`
- Added modular CLI scripts (`cli_request.py`) to support subcommands: `request`, `status`, and `validate`
- Updated configuration: backend API endpoint now set via `VATGENTIC_API_URL` (was `VATGENTIC_N8N_URL`)
- Simplified and focused documentation for faster setup and backend ownership clarity
- Previous manual scripts (`vatgentic-request.py`, etc.) are now replaced/deprecated by unified CLI commands
v0.2.0
- Added comprehensive documentation in SKILL.md covering setup, usage, API, and troubleshooting.
- Emphasized Lightning Network pay-per-use VAT validation; no signup or API keys required.
- Provided clear installation and configuration steps for n8n integration and ln.bot wallet setup.
- Documented example scripts and Python code for agent automation.
- Included pricing information and privacy notes for transparency.
v0.1.1
vatgentic 0.1.1
- Clarified documentation to distinguish between user and instance owner setup steps.
- Emphasized that end users require no configuration; all setup (n8n workflow, VAT API) is handled by the instance owner.
- Cleaned up installation and configuration instructions for better clarity.
- Small rewordings and reorganization for usability in README and SKILL.md.
v0.1.0
Initial release—introduces Lightning Network-powered, pay-per-use VAT validation for EU companies.
- Validate EU VAT numbers instantly and retrieve company details (name, address, validity).
- Simple pay-per-use model (10 sats/validation), no signup or API keys needed.
- Designed for integration by AI agents, developers, and automation workflows.
- Works with ln.bot wallet for Lightning payments and n8n for workflow automation.
- Includes scripts and API endpoints for request initiation, payment status, and result retrieval.
Metadata
Frequently Asked Questions
What is Vatgentic?
Instant EU VAT validation with Lightning Bitcoin. 10 sats per lookup. No subscriptions. It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.
How do I install Vatgentic?
Run "/install vatgentic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Vatgentic free?
Yes, Vatgentic is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Vatgentic support?
Vatgentic is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).
Who created Vatgentic?
It is built and maintained by mcclawd (@mcclawd); the current version is v1.0.0.
More Skills