name: agentic-mcp
description: Agentic MCP - Three-layer progressive disclosure for MCP servers with Socket daemon. Use when the user needs to interact with MCP servers, query available tools, call MCP tools, or manage the MCP daemon process. Provides socket-based communication for efficient server interaction with three-layer progressive disclosure API.

Agentic MCP

Quick start

agentic-mcp daemon start --config <mcp-servers.json path>  # Start daemon
agentic-mcp metadata <server-name>                  # Get server info
agentic-mcp list <server-name>                      # List tools
agentic-mcp schema <server-name> <tool-name>        # Get tool schema
agentic-mcp call <server-name> <tool-name> --params '{"arg":"value"}'  # Call tool
agentic-mcp daemon stop                             # Stop daemon

Core workflow

1. agentic-mcp daemon start - Start daemon
2. agentic-mcp metadata <server> - Layer 1: server info
3. agentic-mcp list <server> - Layer 2: available tools
4. agentic-mcp schema <server> <tool> - Layer 3: tool details
5. agentic-mcp call <server> <tool> --params '{"arg":"value"}' - Execute tool

Daemon management

agentic-mcp daemon start                           # Start daemon
agentic-mcp daemon health                          # Check status
agentic-mcp daemon reload                          # Reload config
agentic-mcp daemon stop                            # Stop daemon
agentic-mcp daemon start --config <path>           # Custom config

Sessions (isolated instances):

MCP_DAEMON_SESSION=<name> agentic-mcp daemon start

Query commands

agentic-mcp metadata <server>                      # Server info
agentic-mcp list <server>                          # List tools
agentic-mcp schema <server> <tool>                 # Tool schema
agentic-mcp daemon health                          # Check daemon status

Tool calls

agentic-mcp call <server> <tool> --params '{"argName":"value"}'

All parameters must be JSON object via --params.

JSON mode:

agentic-mcp metadata <server> --json
agentic-mcp call <server> <tool> --params '{"arg":"value"}' --json

Configuration

mcp-servers.json:

{
  "servers": {
    "<server-name>": {
      "command": "npx",
      "args": ["-y", "@scope/mcp-server"]
    }
  }
}

Socket protocol

Command (newline-delimited JSON):

{"id":"1","action":"metadata","server":"<server>"}

Response:

{"id":"1","success":true,"data":{...}}

Platform: Windows (TCP) / Unix (domain socket)

Examples

Basic usage:

agentic-mcp daemon start
agentic-mcp metadata <server>
agentic-mcp list <server>
agentic-mcp schema <server> <tool>
agentic-mcp call <server> <tool> --params '{"arg":"value"}'

Multiple sessions:

MCP_DAEMON_SESSION=proj1 agentic-mcp daemon start
MCP_DAEMON_SESSION=proj2 agentic-mcp daemon start

Debugging

agentic-mcp daemon health                          # Check status
agentic-mcp daemon reload                          # Reload after config change

Errors

✗ MCP daemon is not running
✗ Server '<name>' not found
✗ Tool '<name>' not found
✗ Required argument '<name>' not provided