Charles MCP Server

Instructions

Implementation Reference

• charles_mcp/tools/reset.py:82-112 (handler)

  The implementation of the `charles_status` tool handler, which checks connectivity to Charles and the status of live captures.

  async def charles_status(ctx: ToolContext) -> CharlesStatusResult:
      """Check Charles connectivity and active live-capture state."""
      logger.info("Tool called: charles_status()")
      deps = get_tool_dependencies(ctx)
  
      active_capture = deps.live_service.get_active_capture()
      result = CharlesStatusResult(
          config=CharlesStatusConfig(
              proxy_url=deps.config.proxy_url,
              base_url=deps.config.charles_base_url,
              config_path=deps.config.config_path or "not_detected",
              manage_charles_lifecycle=deps.config.manage_charles_lifecycle,
          ),
          live_capture=LiveCaptureRuntimeStatus(
              active_capture=ActiveCaptureStatus(**active_capture) if active_capture else None
          ),
          connected=False,
      )
  
      try:
          async with deps.client_factory(deps.config) as client:
              info = await client.get_info()
              result.connected = info is not None
              if info:
                  result.charles_info = info
      except CharlesClientError as exc:
          result.connected = False
          result.error = str(exc)
  
      return result