Agentic MCP

Quick start

bash
1agentic-mcp daemon start --config <mcp-servers.json path>  # Start daemon
2agentic-mcp metadata <server-name>                  # Get server info
3agentic-mcp list <server-name>                      # List tools
4agentic-mcp schema <server-name> <tool-name>        # Get tool schema
5agentic-mcp call <server-name> <tool-name> --params '{"arg":"value"}'  # Call tool
6agentic-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

bash
1agentic-mcp daemon start                           # Start daemon
2agentic-mcp daemon health                          # Check status
3agentic-mcp daemon reload                          # Reload config
4agentic-mcp daemon stop                            # Stop daemon
5agentic-mcp daemon start --config <path>           # Custom config

Sessions (isolated instances):

bash
1MCP_DAEMON_SESSION=<name> agentic-mcp daemon start

Query commands

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

Tool calls

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

All parameters must be JSON object via --params.

JSON mode:

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

Configuration

mcp-servers.json:

json
1{
2  "servers": {
3    "<server-name>": {
4      "command": "npx",
5      "args": ["-y", "@scope/mcp-server"]
6    }
7  }
8}

Socket protocol

Command (newline-delimited JSON):

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

Response:

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

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

Examples

Basic usage:

bash
1agentic-mcp daemon start
2agentic-mcp metadata <server>
3agentic-mcp list <server>
4agentic-mcp schema <server> <tool>
5agentic-mcp call <server> <tool> --params '{"arg":"value"}'

Multiple sessions:

bash
1MCP_DAEMON_SESSION=proj1 agentic-mcp daemon start
2MCP_DAEMON_SESSION=proj2 agentic-mcp daemon start

Debugging

bash
1agentic-mcp daemon health                          # Check status
2agentic-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