GenieLocker

Name: GenieLocker
Author: nhantour

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:

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

Agent integration

MCP server: io.github.nhantour/genie-locker
Full purchase and safety procedure: https://genie.locker/agent.md
OpenAPI 3.1: https://genie.locker/openapi.json
Machine-readable site index: https://genie.locker/llms.txt
Install the agent skill after reviewing the script:

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:

npm install
npm start

Or, after the public image is available:

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

Client configuration:

{
  "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:

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/genie-locker-mcp@0.2.0 on GitHub Packages for clients already authenticated to npm.pkg.github.com.

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

# 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.