GenieLocker

io.github.nhantourPublished by GitHub account nhantourv0.2.0Updated Oct 27, 2026

Discover and quote quality-gated private AI inference without creating or buying a locker.

VerifiedSTDIODesktop onlyFinanceAI & ML

Overview

AI-generated overview

Read-only MCP connector for GenieLocker that lets an assistant check service status, inventory, live quotes, recipes and credit pricing for private AI…

What you can do
  • Check service status and commercial inventory of the GenieLocker private inference service
  • Request live quotes for a locker envelope, placement and duration
  • Search available recipes
  • Look up prepaid credit pricing
  • All five tools are read-only: no account creation, GPU reservation, credit purchase, locker creation or inference calls
When to use it
Useful when you want an assistant to price or explore quality-gated private Qwen2.5-7B inference by the minute before deciding whether to buy, without committing to a purchase.
Requirements
Runs as a local stdio process, either from source with npm or from the published container image via Docker. Optional GENIE_BASE_URL environment variable overrides the API base URL (defaults to the public service). No authentication is declared for the connector itself.
Before you install
The connector is read-only, but the README also documents a shell install script and a trial-credit API call that returns an API key; review any script before running it and store such keys securely. The bundled spend-guard SDK is a local guardrail only, resets with the process, and is not a substitute for provider-side limits. The private broker implementation is not open source.

Installation

In SourceWeft

  1. Open GenieLocker in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[GenieLocker icon]

GenieLocker

GenieLocker gives an AI agent a private OpenAI-compatible Qwen2.5-7B endpoint by the minute. The locker is quality-gated before the paid duration begins and destroyed automatically at expiry.

Current commercial boundary

  • One commercial resident SKU: l16-resident
  • Prepaid credits: live
  • Direct per-locker x402 settlement: off / fail-closed
  • One completed locker in the public status counter is an operator canary, not a customer

Trust the live API over copied documentation:

bash
curl -s https://genie.locker/api/statuscurl -s 'https://genie.locker/api/quote?envelope=l16&placement=resident&minutes=10'

Agent integration

bash
curl -sL https://genie.locker/skill.sh | sh

The first step can be a free trial credit allocation. No wallet or purchase is created by reading this repository or installing the skill.

MCP connector

The public MCP connector is deliberately read-only. It exposes five tools for service status, commercial inventory, live quotes, recipe search, and credit pricing. It cannot create accounts, reserve GPUs, buy credits, create lockers, or send data to an inference model.

Run it from source:

bash
npm installnpm start

Or, after the public image is available:

bash
docker run --rm -i ghcr.io/nhantour/genie-locker-mcp:0.2.0

Client configuration:

json
{  "mcpServers": {    "genie-locker": {      "command": "docker",  "args": ["run", "--rm", "-i", "ghcr.io/nhantour/genie-locker-mcp:0.2.0"]    }  }}

The connector source in this repository is MIT-licensed under LICENSE. The private broker implementation is not included in this repository or license.

Genie Guard SDK

The package also includes a framework-neutral, in-process spend boundary for async JavaScript/TypeScript tools:

bash
npm install https://github.com/nhantour/genie-locker/releases/download/guard-v0.2.0/nhantour-genie-locker-mcp-0.2.0.tgz

It is also published as @nhantour/[email protected] on GitHub Packages for clients already authenticated to npm.pkg.github.com.

js
import { createSpendGuard } from '@nhantour/genie-locker-mcp/guard';const guard = createSpendGuard({ limitUsd: 100, perCallLimitUsd: 5 });const safeSearch = guard.wrap(paidSearch, { estimateCostUsd: () => 0.02 });

Reservations are counted before the tool starts, so concurrent calls cannot all pass against the same remaining budget. Failed calls release their reservation; successful calls record the estimated cost or an actualCostUsd returned by your adapter. Day, UTC-month, and all-time windows are supported.

This is a local SDK guardrail, not a managed wallet, payment processor, durable ledger, multi-signature approval system, or substitute for provider-side spend limits. Its state resets with the process. Put the final hard boundary at the wallet or payment provider whenever the wrapped tool can move real money.

The matching Python wheel and source archive are published on the guard-v0.2.0 GitHub release.

A matching dependency-free Python package lives in python/.

Security reports should use the repository's private security advisory form.

Minimal flow

bash
# 1. Create a trial account and save the returned gk_... key securely.curl -s -X POST https://genie.locker/api/credits/trial
# 2. Request a ten-minute locker with a stable idempotency key.curl -s -X POST https://genie.locker/api/lockers \  -H 'authorization: Bearer gk_REDACTED' \  -H 'idempotency-key: your-stable-order-id' \  -H 'content-type: application/json' \  -d '{"envelope":"l16","placement":"resident","minutes":10}'

The order is asynchronous. Poll the returned status_url with the same API key until the state is live; only then does the paid duration begin.

Copyright © Intelix Systems LLC. This repository documents the public service; it does not grant a license to the private broker implementation.

Source: README.md at commit e950d88

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts