Back to Discover

genie-locker

connector

nhantour

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

View on GitHub
0 starsSynced Aug 3, 2026

Install to Claude Code

/plugin marketplace add nhantour/genie-locker

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:

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

Agent integration

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

Client configuration:

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

The connector source is MIT-licensed under LICENSE-MCP. That license applies only to the connector, not to the private broker implementation.

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.

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

Rendered live from nhantour/genie-locker's GitHub README — not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
oci packageInstall via oci (stdio transport)mcp-serverghcr.io/nhantour/genie-locker-mcp:0.1.0

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.