add-atomic-chat-tool

Integrates Atomic Chat local models as MCP tools for containerized agents.

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-atomic-chat-tool-rosedwayane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-atomic-chat-tool
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-atomic-chat-tool
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-atomic-chat-tool-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, zod, typescript, vitest.

What problem does it solve? Containerized Claude agents cannot directly call local models running in the Atomic Chat desktop app, forcing all inference through the orchestrator model even for cheap tasks like summarization or translation. ## Core Features & Use Cases - MCP Server Registration: Copies a stdio-based MCP server into the agent-runner tree and registers it in index.ts so the agent gains atomic_chat_list_models and atomic_chat_generate tools. - Host Env Forwarding: Adds an atomicChatEnvArgs helper that forwards ATOMIC_CHAT_HOST and ATOMIC_CHAT_API_KEY into the Docker container, with fallback from host.docker.internal to localhost. - Wiring Tests: Ships structural tests (vitest and bun:test) that fail if the registration or env-forwarding integration points are removed. - Use Case: Ask your agent to "use atomic chat to summarize this document" and it will list available local models, then generate a response via Atomic Chat's OpenAI-compatible API on port 1337. ## Quick Start Ask the agent to add the Atomic Chat tool so it can call local models, then verify by sending "use atomic chat to tell me the capital of France".

Frequently Asked Questions about add-atomic-chat-tool

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Atomic Chat local models as tools for a container agent?

Copy the MCP server source into container/agent-runner/src, register an atomic_chat entry in the mcpServers object in index.ts, forward ATOMIC_CHAT_HOST env vars in container-runner.ts, then rebuild the container. The agent then gains atomic_chat_list_models and atomic_chat_generate tools.

How do I connect a Docker container to Atomic Chat running on the host?

The MCP server defaults to http://host.docker.internal:1337 and falls back to localhost if that fails. You can override the endpoint by setting ATOMIC_CHAT_HOST in your .env file, which is forwarded into the container as a Docker -e argument.

Does Atomic Chat require an API key for local inference?

No, Atomic Chat does not require authentication when running locally, so ATOMIC_CHAT_API_KEY can be left unset. Only set it if you have placed Atomic Chat behind a reverse proxy that enforces authentication.

Why does the agent say Atomic Chat is not installed or try to run a CLI?

This means the MCP server was not copied, not registered in the mcpServers object in index.ts, or the container was not rebuilt. Check that atomic-chat-mcp-stdio.ts exists in the agent-runner tree and run ./container/build.sh again.

Why does atomic_chat_generate return a model not found or 404 error?

The model ID passed to atomic_chat_generate must exactly match one of the IDs returned by atomic_chat_list_models. Ask the agent to list models first, then pick one from that list before generating.

Why is the first Atomic Chat response slow?

Atomic Chat lazy-loads models into memory on first use, so the initial call takes longer while the model warms up. Subsequent calls against the same model are fast.