Skip to main content

​
Synopsis

profclaw mcp <subcommand> [flags]

​
Description

mcp manages connections to external MCP (Model Context Protocol) servers and can run profClaw itself as an MCP server. MCP servers expose tools that agents can call during execution. profClaw can connect to multiple MCP servers simultaneously, making all their tools available to agents.

​
Subcommands

SubcommandAliasDescription
status-Show connection status for all configured MCP servers
list-toolstoolsList all tools from connected MCP servers
connect <name>-Connect to a configured MCP server
disconnect <name>-Disconnect from an MCP server
serve-Start profClaw as a standalone MCP server (stdio mode)

​
mcp status

​
--json
boolean
Output as JSON with server name, transport, connection status, and tool count.

​
mcp list-tools

Lists all tools currently available from connected MCP servers, grouped by server.
​
--json
boolean
Output as JSON with tool name, server, and description.

​
mcp connect <name>

​
name
string
required
Name of the MCP server as defined in your profClaw config.
​
--json
boolean
Output connection result as JSON.

​
mcp disconnect <name>

​
name
string
required
Name of the MCP server to disconnect.

​
mcp serve

Starts profClaw as a standalone MCP server over stdio. Use this to connect profClaw’s tools to Claude Desktop, Cursor, or any other MCP-compatible client. Requires a production build (pnpm build).

​
Examples

profclaw mcp status

​
MCP Server Configuration

Configure MCP servers in config/settings.yml: 
mcp:
  servers:
    - name: filesystem
      transport: stdio
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    - name: github
      transport: stdio
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: "${GITHUB_TOKEN}"

​
Claude Desktop Integration

To use profClaw tools in Claude Desktop, add to claude_desktop_config.json: 
{
  "mcpServers": {
    "profclaw": {
      "command": "profclaw",
      "args": ["mcp", "serve"]
    }
  }
}