# GenieLocker

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/nhantour/genie-locker  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/genielocker

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "genielocker": {
    "command": "npx",
    "args": ["-y","genielocker"]
  }
}
```

## Documentation & README

<p align="center">
  <img src="https://raw.githubusercontent.com/nhantour/genie-locker/HEAD/assets/genie-locker-icon.png" alt="GenieLocker icon" width="160" height="160">
</p>

# 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/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:

```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 install
npm 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/genie-locker-mcp@0.2.0` 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](https://github.com/nhantour/genie-locker/releases/tag/guard-v0.2.0).

A matching dependency-free Python package lives in [`python/`](https://github.com/nhantour/genie-locker/blob/HEAD/python/).

Security reports should use the repository's private
[security advisory form](https://github.com/nhantour/genie-locker/security/advisories/new).

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