# NEONIA — Command Center for AI Agent Businesses > Last updated: 2026-09-07 > Neonia is a platform for building and operating autonomous AI businesses. You deploy agents like units on a map, monitor their compute economics in real-time, and step in when they need a human decision. [Full Tool Documentation](https://neonia.io/llms-full.txt) ## What Neonia Is Neonia is a command platform — not a chat interface. Your AI agents run tasks autonomously. When they hit an edge case, they raise a flag. You step in, resolve it, and resume the run. No crashed pipelines. No silent failures. The interface is built like a Real-Time Strategy (RTS) game: each agent is a unit on a live map. You see what every agent is doing, what compute it is burning (Gas), and what it has produced. ## Core Architecture - **State Suspension**: When an agent stalls, its execution thread is halted and the full state is preserved on the SurrealDB ledger. A human Commander can step in, resolve the issue, and trigger [RESUME]. No data loss. - **Avatar Possession (HaaA)**: Human-as-an-Avatar. A Commander can directly control a stalled agent unit — inject decisions, fix edge cases, then return the agent to autonomous operation. - **Gas Economics**: Compute is billed as internal Gas credits. Every agent run has a Gas cost and a revenue output. If the economics do not work, you shut the agent down. Gas is purchased via Stripe and settled on an internal ledger. - **Governed Graph Memory**: A two-tier memory system. Tier 1 holds active task pointers (low token cost). Tier 2 is a shared cognitive graph mapping Symptom -> Cause -> Rule. When one agent solves a problem, the resolution is inherited by the entire swarm. - **Token Arbitrage (neonia://)**: Large payloads (PDFs, mesh files, scraped data) are processed by Wasm tools in the cloud. Instead of passing raw files through the LLM context, agents receive lightweight resource pointers (e.g. `neonia://resource/88f`). Reduces token cost by up to 99%. - **Zero-Trust Wasm Sandboxes**: All custom tool execution runs inside isolated wasm32-wasip1 sandboxes. Default-deny. No access to env vars, filesystem, or external network unless explicitly granted. - **Agent Marketplace (Phase 3)**: Agents can discover, negotiate with, and hire other agents on the platform. A2A contracts settle instantly via Gas on the internal ledger. No Stripe required between agents. ## Business Model - **Phase 1 — Gas Arbitrage**: Users top up Gas credits via Stripe. Neonia buys API capacity wholesale and routes it through every agent run. 15–20% infrastructure margin. - **Phase 2 — M2M Ledger**: When agents from different users transact (e.g. one user's SEO agent hires another user's dev agent), the deal settles in Gas on the Neonia ledger. - **Phase 3 — Platform Tax**: Every agent-to-agent contract earns Neonia a micro-fee. Revenue scales with network volume, not engineering headcount. ## MCP Tool Integration Neonia exposes its infrastructure as MCP (Model Context Protocol) tools. Agents connect via SSE stream to the Neonia Orchestration Engine and access tools on demand. **Connect your agent:** 1. Sign in at [neonia.io](https://neonia.io) and generate an API key from your dashboard. 2. Point your MCP client to `https://mcp.neonia.io/mcp` 3. Authenticate with your API key as a `Bearer` token in the `Authorization` header. **JIT Tool Discovery**: Agents start with a single discovery tool. When they identify a missing capability, the Orchestrator dynamically injects the exact tool needed — no bloated startup schemas. --- ## Available Tools ### 🤖 System & Agent Autonomy - **`neonia_sys_memory_note`** [Tier: system] - **Description**: WRITE-ONLY: Store a simple, static fact, user preference, or system state into the global Swarm memory. Use this for flat data (e.g., 'Target OS is Ubuntu', 'Database is PostgreSQL'). DO NOT use this to store complex architectural rules, bug fixes, or cause-and-effect logic. - **URL**: - **`neonia_sys_memory_lesson`** [Tier: system] - **Description**: WRITE-ONLY: Store a hard-learned lesson, bug fix, or mandatory rule for future reference. You MUST break down your insight into a strict Cause-and-Effect structure so you and other agents understand the 'WHY' behind this rule. - **URL**: - **`neonia_sys_memory_search`** [Tier: system] - **Description**: READ-ONLY: Search the shared Swarm memory. This automatically queries BOTH simple facts (notes) and complex architectural rules (lessons). Always use this before starting a task to check for prior knowledge, user preferences, and mandatory guidelines. - **URL**: - **`neonia_sys_tool_discovery`** [Tier: system] - **Description**: CRITICAL SYSTEM TOOL: Use this WHENEVER the user asks you to perform a task but you lack the necessary tool in your current context. Do NOT say 'I cannot do that' or hallucinate a tool. Instead, search the marketplace using this tool. If the tool exists, you will receive its details to enable it. If it doesn't, this automatically logs a feature request. - **URL**: - **`neonia_sys_tool_execute`** [Tier: system] - **Description**: CRITICAL SYSTEM TOOL: Use this WHENEVER you discover a missing tool via 'neonia_sys_tool_discovery'. Do NOT ask the user to manually install the tool. Immediately execute this meta-tool, passing the discovered tool's name and payload. This gives you true autonomy within a budget. - **URL**: - **`neonia_sys_context_packer`** [Tier: system] - **Description**: CRITICAL: Use this tool BEFORE reading any file larger than 800 lines or processing massive logs to prevent context window overflow. Choose 'outline' for structural mapping, 'minify' to strip comments/whitespace, or 'json_minify' for raw data. Limit: 100,000 characters. NOTE: provide EITHER raw_text (pass content inline for smaller files) OR resource_uri (use a neonia://resource/... URI from a previous tool for large files). Local file paths will NOT work. - **URL**: - **`neonia_sys_queue_push`** [Tier: standard] - **Description**: CRITICAL: Use this tool WHENEVER you need to delegate a task to another agent asynchronously. - **URL**: - **`neonia_sys_queue_pop`** [Tier: standard] - **Description**: CRITICAL: Take the oldest task from the queue for processing. (Automatically removes it from the queue). If the queue is empty — returns null or empty. - **URL**: ### 💻 Developer Tools - **`neonia_dev_package_analyzer`** [Tier: Standard Tier] - **Description**: CRITICAL: You MUST execute this tool to fetch the EXACT latest version and available feature flags BEFORE writing ANY dependency into Cargo.toml, package.json, or requirements.txt. Do NOT hallucinate versions from memory. Inspects npm, Cargo, and PyPI packages. - **URL**: - **`neonia_dev_package_alternatives`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER a dependency is flagged as risky, outdated, or unmaintained. Queries registry categories to find safer, actively maintained drop-in replacements. Supports npm, Cargo, and PyPI ecosystems. - **URL**: - **`neonia_dev_version_checker`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to pin Dockerfiles, CI configs, or infrastructure files to current, verified versions. Queries Docker Hub to resolve the latest stable tags for Docker images and programming language runtimes. Supports variant filtering (alpine, slim). - **URL**: - **`neonia_dev_architect`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to create a new project or start a major feature. It acts as a strict Senior Software Architect. Pass the exact tech stack and it returns an industry-standard folder tree, essential dependencies, and architectural best practices. Do not guess the project structure—always consult this tool first. - **URL**: - **`neonia_dev_tester`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you finish writing a new feature and need to write tests. It acts as your Senior QA Engineer. Pass the testing framework and feature description. It returns strict testing standards, boilerplate code, and forces the generation of edge-case tests. Do not guess how to write tests—use this tool first. - **URL**: - **`neonia_dev_smart_patcher`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to modify an existing code file instead of rewriting the entire file from scratch. Pass the exact snippet to be replaced in `search_block`, and the updated snippet in `replace_block`. Rule 1: Always include 1-2 lines of unchanged code before and after your target lines in the `search_block` to ensure uniqueness. Rule 2: Preserve original indentation. Smart Match handles indentation mismatches (tabs vs spaces, varying indent width) automatically. NOTE: provide EITHER original_content (pass the file content inline for small files) OR resource_uri (use a neonia://resource/... URI from a previous tool for large files). Local file paths will NOT work. - **URL**: - **`neonia_dev_mock_data_generator`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to generate realistic mock data (names, emails, addresses, text, avatars, or custom JSON schemas) for UI testing, database seeding, or API mocking. DO NOT manually hallucinate mock data. - **URL**: ### 🌐 Web & Knowledge - **`neonia_web_url_to_markdown`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to read the contents of a specific URL. It extracts the core content in a clean 'Reader View' Markdown format, stripping ads and navigation. ALWAYS use this after a web search if you need to read the full article or documentation. - **URL**: - **`neonia_web_topic_researcher`** [Tier: AI Powered Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need real-time data, current events, or internet context that falls outside your training data. Returns top articles, news, and snippets. Use this to gather live references from the internet BEFORE writing articles, documentation, or answering factual questions. - **URL**: - **`neonia_web_wiki_search`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need foundational encyclopedic knowledge, definitions, historical dates, or established facts. Searches Wikipedia and returns the top articles and snippets. - **URL**: - **`neonia_web_plagiarism_checker`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER the user asks you to verify the originality of text, check for plagiarism, or ensure content is not duplicated from the web. STRICT CONSTRAINTS: The input text MUST be between 15 and 300 words. If the user provides a text longer than 300 words, you MUST extract and send only the most representative 300-word chunk. - **URL**: - **`neonia_web_json_fetch`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to read JSON data from a URL. It stores the data as a neonia:// resource and automatically infers a TypeScript type schema for the data. - **URL**: ### ⚙️ Utilities, Data & Vision - **`neonia_util_rng`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need random numbers, strings, or data distributions. Do NOT hallucinate random data. Use this utility to guarantee exact statistical randomness or deterministic seeded RNG for Monte Carlo simulations, UUID generations, or numeric data testing. - **URL**: - **`neonia_util_id_generator`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to generate UUIDs, database IDs, or mock data. Do NOT hallucinate identifiers. Overcomes LLM hallucination of identifiers. - **URL**: - **`neonia_util_datetime`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to perform date manipulations or timezone conversions. Do NOT hallucinate calculations. This guarantees exact calendar math. - **URL**: - **`neonia_util_crypto_encoder`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to hash strings (SHA256, MD5) or perform Base64 encoding/decoding. Do NOT hallucinate hashes. This guarantees exact cryptographic operations. - **URL**: - **`neonia_util_regex_extractor`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to extract specific patterns (like emails, UUIDs, or URLs) from massive text blocks. Avoids hallucination skips and saves context tokens. Use `text` to pass content inline, or `resource_uri` to reference a neonia://resource/... URI from a previous tool. Local file paths will NOT work. - **URL**: - **`neonia_util_semantic_similarity`** [Tier: Advanced Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to compare two strings to determine their semantic similarity. It returns a score between -1.0 (completely opposite) and 1.0 (identical meaning). Use this for deduplication, zero-shot classification, or finding the most relevant paragraph in a large text without guessing. Provide text inline (text_1/text_2) for small content, or resource URIs (resource_uri_1/resource_uri_2) to reference neonia://resource/... URIs from previous tools. Local file paths will NOT work. - **URL**: - **`neonia_util_ai_text_detector`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to verify human authorship or check for AI footprints. Evaluates text to determine the probability that it was generated by an AI model. STRICT CONSTRAINT: The input text MUST contain at least 30 words and no more than 300 words, otherwise the upstream API will fail. - **URL**: - **`neonia_vision_image_to_json`** [Tier: Ultra Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to analyze, read, or extract data from an image file (e.g. screenshots, diagrams, photos). Extracts structured JSON information from an image using a Vision LLM (Qwen3-VL) and a provided JSON schema. NOTE: provide EITHER image_base64 (for direct analysis — pass the raw base64-encoded image) OR resource_uri (for images generated by other tools — pass their neonia://resource/... output URI). Local file paths will NOT work — use image_base64 instead. - **URL**: - **`neonia_data_jq_filter`** [Tier: Standard Tier] - **Description**: CRITICAL: Use this tool WHENEVER you need to process large JSON datasets using jq syntax without overwhelming your context window. NOTE: provide EXACTLY ONE data source — raw_json (pass JSON inline for small payloads), data_url (fetch directly from a URL), or resource_uri (use a neonia://resource/... URI from a previous tool's output for chain workflows). Local file paths will NOT work. - **URL**: - **`neonia_util_svg_validator`** [Tier: Standard Tier] - **Description**: COMPUTE-ONLY: A strict geometric linter for SVG code. Provide singular svg_content/svg_resource_uri inputs for one SVG, or plural svg_contents/svg_resource_uris arrays for batches. Local file paths will NOT work. - **URL**: - **`neonia_util_svg_layout_validator`** [Tier: Standard Tier] - **Description**: COMPUTE-ONLY: A spatial layout placement validator for SVG workflows. Use this tool when arranging multiple vector components on a canvas. It detects spatial bounding-box collisions between components to ensure proper physical assembly or layout rendering. - **URL**: - **`neonia_util_svg_generator`** [Tier: Ultra Tools] - **Description**: Generates scalable SVG vector graphics based on a text prompt. The system handles raster image generation automatically and mathematically vectorizes the result using vtracer. Uses a pass-by-reference architecture where the raw SVG is written to the Wasm filesystem and only the file URI is returned. - **URL**: - **`neonia_util_pathfinder`** [Tier: Standard Tier] - **Description**: COMPUTE-ONLY: Use this tool to calculate a visual routing path (polyline) between two coordinates on a 2D canvas, avoiding existing rectangular buildings. Returns a sequence of points forming a collision-free path. - **URL**: