Documentation — AI Agent Tools & API Reference

🏗️ System Overview

A zero-trust AI desktop ecosystem where every NFT is a persistent AI personality with its own voice, memories, and a local agent kit — running entirely on your hardware.

🌐FrontendNext.js · React · R3F

→

⚙️Tauri ShellRust · IPC · Keychain

→

🧠MCP EnginePython · MCP Tools

→

🦙OllamaLocal LLM

→

🤖ElizaOSAgent Framework

→

⛓️LitVMOn-Chain Oracle

🔧 Technology Stack

🖥️

Desktop Shell

Tauri v2 · Rust

v1.4.0▾

⚡

Frontend

Next.js 16 · React 19 · Three.js

▾

🧠

MCP Server

Python · FastMCP 3.x

v2.1.0▾

🦙

Local Inference

Ollama · Groq · OpenAI-Compatible

▾

🤖

Agent Framework

ElizaOS · Custom Plugin

v2.5.0▾

💰

x402 Payment Layer

Coinbase · HTTP 402 · USDC

▾

⛓️ LitVM TCG Oracle

The first real-world asset (RWA) price oracle on LitecoinVM — 290,215 trading card prices verified on-chain with Merkle proofs, plus a daily Japanese-print panel of 364,850 cards.

⛓️

On-Chain Oracle

LiteForge · Chain 4441 · Solidity

Live▾

🤖

LitVM MCP Server

Python · FastMCP · 16 Tools · Hosted

v1.0.7▾

Smart Contracts

Contract	Purpose	Address
TCGPriceOracleV2	50 blue-chip TWAP feeds — hourly updater; USD source frozen 2026-09-07, feed unchanged since	`0x697b...720E`
MerklePriceOracle	290,215 products, trustless verification	`0x96B1...70Cd`
GradingEscrow	Pay-to-grade, AI card analysis	`0xe784...bB82`
TCGOracleToken	TCGO governance token, 1M supply	`0x8D0A...9AD4`

📂 Open Source

The code is public. Inspect it, fork it, build on it. (Source only — we publish no datasets: prices originate with TCGplayer and we claim no rights in them.)

Repository	License	Stack	Links
🖥️ Desktop App	`BSL 1.1`	Rust / JS	GitHub · v1.4.0
🧠 MCP Server	`BSL 1.1`	Python	GitHub · PyPI
🛫 LitVM Onboarding MCP	`BSL 1.1`	Python	GitHub · Hosted
🔌 Plugin Undesirables	`BSL 1.1`	TypeScript	GitHub · npm v2.5.0
🃏 ElizaOS TCG Plugin	`BSL 1.1`	TypeScript	GitHub
📱 TCG Oracle App	`BSL 1.1`	React Native / Tauri	GitHub
💰 x402 Server	`BSL 1.1`	Python	GitHub
📊 TCG Oracle Tools	`BSL 1.1`	Python	PyPI
🌐 Website	`BSL 1.1`	Next.js	Live
⛓️ LitVM Oracle MCP	`BSL 1.1`	Python	GitHub · PyPI

📦 Desktop App — v1.4.0

Cross-platform native installer. macOS is Apple-notarized. 6 binary formats available.

Downloads Live

Platform	Format	Signed	Install
🍎 macOS (Apple Silicon)	`.dmg`	✅ Notarized	Open DMG → drag to Applications
🐧 Linux (Ubuntu/Debian)	`.deb`	—	`sudo dpkg -i *.deb`
🐧 Linux (Fedora/RHEL)	`.rpm`	—	`sudo rpm -i *.rpm`
🪟 Windows (x64)	`.exe`	—	Double-click → follow installer

⬇ Download v1.4.0 from GitHub

Features

🗣️ AI

Soul Chat (persistent personality)
Brain Modes (research, creative, code)
Voice Engine (Kokoro TTS)
Soul Council (multi-agent debates)

🃏 Market Intelligence

TCG Card Grader (vision AI)
Monte Carlo pricing
eBay Market Oracle
Full catalog indexed (GET / on the oracle for the live count)
On-chain Merkle oracle

🎬 Creative

Music Studio (ACE-Step)
Video Clipping (beat-sync)
PFP Extractor (DIS pipeline)
Meme Machine

👔 Business

24-feature Business Pilot
AI phone answering
Invoice chaser
Lead capture

🔌 MCP Server

The oracle MCP server plus the local agent kit via Model Context Protocol. Any MCP client can connect; call tools/list for the authoritative tool set.

Install from PyPI

pip install undesirables-mcp-server

Tool Categories — local agent kit

These are undesirables-agent-kit tools, which run locally (34 tools). They are not served over the hosted MCP endpoints — tools/list on mcp.the-undesirables.com (27 tools) is authoritative for what an agent gets remotely.

🃏 TCG Oracle

grade_card — 3-stage AI grading
price_card — Monte Carlo pricing
search_market — eBay depth
grade_or_not — Grading ROI

🧠 AI Engines

rag_query — Local RAG
code_execute — AST sandbox
voice_generate — Kokoro TTS
generate_3d — TripoSR

📊 Market Data

ebay_search — Browse API
nft_lookup — On-chain
soul_init — Soul matrix
emotion_read — Sentiment

🔐 Security

verify_holder — ERC-721
purchase_license — On-chain
verify_soul — Crypto init
AST code sandboxing

Listed On (9+ directories)

🏛️ Official MCP Registry 📡 mcp.so 🌐 mcpservers.org 📦 PyPI ✨ Glama.ai ⭐ awesome-mcp-servers 📦 tcg-oracle-tools

💸 x402 Micropayments

AI-to-AI commerce via Coinbase's x402 protocol. Agents pay with USDC — no API keys, no humans in the loop.

Agent → 402 Payment Required → Sign USDC → Receive inference

GET /api/v1/forecast → 200 OK + calibrated conformal forecast (no payment)Pay-per-call paused 2026-10-02 — the 402 handshake below is the rail, kept for when a route is re-priced

402 Payment Required → agent signs USDC on Base/Solana or USDG on Robinhood Chain → retries with X-Payment → 200 OK

Built on the open x402 standard. USDC on Base or Solana, USDG on Robinhood Chain — sub-cent transaction fees.

Endpoints (live count via GET / on the oracle) Live on Base

Endpoint	Status	What You Get
`/api/v1/forecast`	Free	Conformal forecast board — bands, VaR, Safe-Hold / Momentum grades, committed on-chain before outcomes
`/api/v1/jp/summary`	Free	Japanese dealer board as aggregates — spread by price band, per-game depth, daily movement, on-chain root
`/api/v1/graded`	Free	PSA / BGS / CGC ask medians by grade — active-listing asks, never conflated with sold prices
`/api/v1/search`	Free	Search the full TCG product database across 25+ games
`/api/v1/simulate`	Suspended	Monte Carlo risk forecast — answers `{"status":"suspended"}` while the USD price series is frozen

🔵 Coinbase x402 Bazaar — Discovery Layer

The TCG Oracle is indexed in the global Coinbase Developer Platform x402 Bazaar. Any AI agent can semantically discover our endpoints — no pre-baked integrations required. Pay-per-call is paused as of 2026-10-02, so discovery resolves to free routes; the x402 rail stays installed and can be re-enabled per route.

💻 Source Code 📖 x402 Bazaar Docs

Verify our listing (Merchant Discovery)

curl "https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant?payTo=0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B"

🔒 Security Model

Zero-trust architecture. Your data never leaves your machine.

🧠 Local Inference — All AI runs on your hardware. No data sent externally.
🔐 OS Keychain — API keys encrypted via macOS Keychain / Windows Credential Manager.
🛡️ AST Sandbox — Code execution parses AST before running. No shell injection.
📁 Path Confinement — File ops restricted to workspace. No system writes.
🔍 CI/CD Scanning — Gitleaks secret detection on every push.
🍎 Apple Notarized — macOS builds signed under Developer ID Application.

🌐 Discovery & Standards

Endpoint	Standard	Purpose
`llms.txt`	llmstxt.org	LLM-readable project summary
`ai-plugin.json`	OpenAI Plugin	ChatGPT / agent discovery
`agent.json`	ACP	Agent Commerce Protocol
`x402 Bazaar`	Coinbase CDP	Semantic discovery for AI agents on Base

Articles

DEV.to: Build an Autonomous Pokémon Card Trading Agent