# Show Nats Status

> Show the current status of the Claude Code NATS agent — connection info, NATS URL, and all discovered agents with their capabilities. Use when the user says "nats status", "show nats agents", "what agents are connected", or wants to see the agent network state. Use when this capability is needed.

- Skill: `tomevault-io/show-nats-status` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/show-nats-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/show-nats-status/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/show-nats-status

---


<objective>
Shows the connection state of the local NATS agent and all known agents from the local cache. The NATS MCP server is managed automatically by Claude Code via the channel feature — no manual start/stop needed.
</objective>

<quick_start>
`/nats:show-nats-status`
</quick_start>

<workflow>
**1. Configuration:**

Read `~/.claude/channels/nats/.env` if it exists. Show:
- `NATS_URL`: value or "(not configured — using defaults: nats://nats:4222, nats://nats-server:4222)"

**2. This agent's ID:**

Read `~/.claude/skills/nats/agent-id` if it exists. Show the agent ID, or "(not yet assigned — the channel server assigns one on first run)".

**3. MCP server and connection:**

Use the `get_agents` MCP tool to check whether the NATS MCP server is connected. If the tool call succeeds, the server is running and NATS is reachable. If it fails, note that the channel may not be active — the user can restart Claude Code with `--channels plugin:nats@claude-skills`.

**4. Discovered agents:**

Display the result of `get_agents`. For each agent:
- Agent ID
- Name
- Last seen (ISO timestamp)
- Capabilities (type + name + description)

Format as a structured list. If the cache is empty, suggest running `/nats:discover-agents` to scan the network.

**5. Hint:**

Agent cache is at `~/.claude/channels/nats/agents.json`.
Run `/nats:discover-agents` for a live scan of all connected agents.
</workflow>

<success_criteria>
- NATS URL and agent ID displayed (or clear not-configured messages)
- Agent list from cache shown with capabilities
- MCP server connectivity confirmed or failure explained
- User knows next step (discover if cache empty, reconfigure if URL missing)
</success_criteria>

---
> Source: [cameri/claude-skills](https://github.com/cameri/claude-skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->