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