Skip to content

pitchfork mcp

  • Usage: pitchfork mcp

Runs a Model Context Protocol (MCP) server over stdin/stdout

This command starts an MCP server that exposes pitchfork daemon management to AI assistants (Claude, Cursor, etc.) over stdin/stdout using JSON-RPC.

Typically used as a subprocess by an MCP-aware AI agent.

Examples:

In claude_desktop_config.json or similar:

{ "mcpServers": { "pitchfork": { "command": "pitchfork", "args": ["mcp"] } } }

Tools provided: pitchfork_status List all daemons and their state pitchfork_start Start a named daemon pitchfork_stop Stop a named daemon pitchfork_restart Restart a named daemon pitchfork_logs Return recent log output for a daemon

Examples:

Start the MCP server (used by AI assistant tools)

$ pitchfork mcp

Claude Desktop configuration (claude_desktop_config.json):

{ "mcpServers": { "pitchfork": { "command": "pitchfork", "args": ["mcp"] } } }

Interactive testing with JSON-RPC:

$ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | pitchfork mcp

Available tools:

  • pitchfork_status - List all daemons and their state
  • pitchfork_start - Start daemon(s) by name
  • pitchfork_stop - Stop daemon(s) by name
  • pitchfork_restart - Restart daemon(s) by name
  • pitchfork_logs - Return recent log output for daemon(s)

Released under the MIT License.