GenieLocker — Private AI by the Minute
This server provides read-only access to GenieLocker's service status, commercial inventory, pricing, and recipe search—without creating accounts, reserving GPUs, or spending funds.
genie_status: Check current service status, including catalog, capacity, sellability, locker counts, and payment-rail status.
genie_catalog: List lifecycle-verified commercial SKUs eligible for purchase (live inventory only).
genie_quote: Get a live, non-binding price quote for a private locker by specifying envelope, placement, and duration (10–1440 minutes).
genie_recipes: Search public agent and inference recipes by query, maturity stage (
commercial,benchmarked,designed), or category.genie_credit_pricing: Read prepaid credit definitions, burn multipliers, tier pricing, and usage examples.
Limitations: Cannot create accounts, purchase credits, reserve GPUs, or create lockers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GenieLocker — Private AI by the Minute Get a live quote for a 10-minute l16-resident locker."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-residentPrepaid 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'Related MCP server: TokenLab MCP Server
Agent integration
MCP server:
io.github.nhantour/genie-lockerFull 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 | shThe 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 startOr, after the public image is available:
docker run --rm -i ghcr.io/nhantour/genie-locker-mcp:0.2.0Client 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.tgzIt 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.
Copyright © Intelix Systems LLC. This repository documents the public service; it does not grant a license to the private broker implementation.
Available Tools
5 toolsgenie_catalogList commercial GenieLocker inference SKUsARead-onlyIdempotent
Read only the lifecycle-verified SKUs that are currently eligible for purchase. Designed or benchmarked recipes are not represented as commercial inventory.
Inputs: no named parameters.
genie_credit_pricingRead GenieLocker prepaid credit pricingARead-onlyIdempotent
Read the current credit definition, burn multipliers, tier pricing, and examples. This never creates a wallet or buys credits.
Inputs: no named parameters.
genie_quoteQuote a private inference lockerARead-onlyIdempotent
Get a live, non-binding price quote. This is read-only and does not reserve capacity, create an account, or spend funds.
Inputs: minutes, envelope, placement.
genie_recipesFind GenieLocker agent and inference recipesARead-onlyIdempotent
Search the public recipe menu by maturity, category, or text. The stage field is authoritative: only stage=commercial is live inventory.
Inputs: query, stage, category.
genie_statusCheck GenieLocker service statusARead-onlyIdempotent
Read current catalog, capacity, sellability, locker counts, and payment-rail status. This never creates or purchases a locker.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct aspect: overall status, purchasable catalog, quotes, recipes, and credit pricing. The descriptions clearly differentiate catalog (commercial-only) from recipes (all stages), eliminating ambiguity.
All tools follow the consistent 'genie_' prefix followed by a descriptive noun (status, catalog, quote, recipes, credit_pricing). This uniform pattern is predictable and easy to navigate.
Five tools is an ideal size for a read-only information server, covering the essential domain areas without unnecessary bloat or sparsity.
The surface comprehensively covers the informational needs of the domain: overall status, available inventory, live pricing, recipe search, and credit definitions. Since all tools are explicitly read-only, there are no missing write operations for this server's stated purpose.
Maintenance
Related MCP Connectors
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Public read-only MCP server for Genvernium product and developer resources.
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Public, read-only MCP server for FarmNeural company facts, packages, and capabilities.
Related MCP Servers
- AlicenseAqualityBmaintenanceRead-only MCP server for Blocksize real-time market data: crypto VWAP, bid/ask, FX, metals and tokenized equities, with pricing, coverage and x402 endpoint lookup. Signed-in users of the Claude, ChatGPT and Cursor connectors get 30,000 free live-data credits every month (1 credit = $0.001); subscriptions from EUR 49/month.71MIT
- AlicenseCqualityBmaintenanceRead-only MCP server that exposes public TokenLab model catalog tools for agents to discover models, inspect request contracts, and compare pricing.321,120 npm1MIT
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server providing 5 tools for hybrid search, clause retrieval, policy versioning, code lookup, and plan rider override queries over a synthetic medical-policy corpus.-
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server that performs deterministic local preflights of agent-payment boundary documents and x402 v2 PaymentRequired JSON, and prepares unsubmitted public quote-request drafts without network calls or fund movement.1-